Home » Adobe Manuals » Computer Software » Adobe 12001196 » Manual Viewer

Adobe 12001196 Scripting Guide - Page 79

Converting from a string to a date, Date arithmetic, scand

UPC - 718659085742

View all Adobe 12001196 manuals

Add to My Manuals
Save this manual to your list of manuals

Page 79 highlights

A Short Acrobat JavaScript FAQ A How do I use date objects? Converting from a string to a date To convert a string into a Date object the scand of the Util Object is used. It accepts a format string that it uses as a hint as to the order of the year, month, and day in the input string. /* Example of util.scand */ /* Create some strings containing the same date in differing formats. */ var s1 = "03/12/97"; var s2 = "80/06/01"; var s3 = "December 6, 1948"; var s4 = "Saturday 04/11/76"; var s5 = "Tue. 02/01/30"; var s6 = "Friday, Jan. the 15th, 1999"; /* Convert the strings into Date objects using util.scand */ var d1 = util.scand("mm/dd/yy", s1); var d2 = util.scand("yy/mm/dd", s2); var d3 = util.scand("mmmm dd, yyyy", s3); var d4 = util.scand("mm/dd/yy", s4); var d5 = util.scand("yy/mm/dd", s5); var d6 = util.scand("mmmm dd, yyyy", s6); /* Print the dates to the console using util.printd */ console.println(util.printd("mm/dd/yyyy", d1)); console.println(util.printd("mm/dd/yyyy", d2)); console.println(util.printd("mm/dd/yyyy", d3)); console.println(util.printd("mm/dd/yyyy", d4)); console.println(util.printd("mm/dd/yyyy", d5)); console.println(util.printd("mm/dd/yyyy", d6)); The output of this script would look like: 03/12/1997 06/01/1980 12/06/1948 04/11/1976 01/30/2002 01/15/1999 Unlike the date constructor (new Date(...)), scand is rather forgiving in terms of the string passed to it. NOTE: Given a two digit year for input, scand resolves the ambiguity as follows: if the year is less than 50 then it is assumed to be in the 21st century (i.e. add 2000), if it is greater than or equal to 50 then it is in the 20th century (add 1900). This heuristic is often known as the Date Horizon. Date arithmetic It is often useful to do arithmetic on dates to determine things like the time interval between two dates or what the date will be several days or weeks in the future. The JavaScript Date object provides several ways to do this. The simplest and possibly most easily understood method is by manipulating dates in terms of their numeric Acrobat JavaScript Scripting Guide 79

Section	Page
Acrobat JavaScript Scripting Guide	1
Contents	3
Preface	7
Introduction	7
Audience	7
Purpose and Scope	7
Assumptions	8
Organization	8
How To Use This Guide	8
Font Conventions Used in This Book	9
For More Information	10
Introduction to Acrobat JavaScript	11
Introduction	11
Chapter Goals	11
Contents	11
Overview	11
What Is Acrobat JavaScript?	12
What Can You Do with Acrobat JavaScript?	13
Acrobat JavaScript Object Overview	15
The App object	15
The Doc Object	15
Other Common Acrobat JavaScript Objects	16
Database Objects	17
JavaScript Language Caveats	17
Acrobat JavaScript Editor and Debugger Console	19
Introduction to the JavaScript Editor and Debugger Console	19
Chapter Goals	19
Contents	19
JavaScript Console	20
Opening the JavaScript Console	20
Executing JavaScript	20
Formatting Code	20
Using a JavaScript Editor	21
Specifying the Default JavaScript Editor	23
Using the Built-in Acrobat JavaScript Editor	24
Using an External Editor	24
Additional Editor Capabilities	24
Specifying Additional Capabilities to Your Editor	25
Testing Whether Your Editor Supports Opening at Syntax Error Locations	26
Exercise: Working with the JavaScript Console	27
Enabling JavaScript	27
Enabling the Interactive JavaScript Console	28
Trying out the JavaScript Console	28
Acrobat JavaScript Debugger	33
Introduction to the Acrobat JavaScript Debugger	33
Chapter Goals	33
Contents	33
Enabling the Acrobat JavaScript Debugger	34
Debugger Dialog Window	36
Main Groups of Controls	36
Debugger View Windows	36
Debugger Buttons	37
Resume Execution	38
Interrupt	38
Quit	39
Step Over	39
Step Into	39
Step Out	39
Debugger Scripts Window	40
Accessing Scripts in the Scripts Window	40
Scripts Inside PDF Files	40
Scripts Outside PDF Files	41
Call Stack List	41
Inspect Details Window	42
Details Window Controls	42
Inspecting Variables	43
Watches	44
Breakpoints	44
Starting the Debugger	46
Debugging From the Start of Execution	46
Debugging From an Arbitrary Point in the Script	46
Stepping Through Your Code	47
Exercise: Calculator	47
Calculator	48
Getting Started	49
Debugging a runtime error	50
Another runtime error	51
Known Issues	52
Summary	53
Using Acrobat JavaScript in Forms	55
Creating simple JavaScripts	55
Creating an automatic date field	55
Performing Arithmetic Calculations	56
Assigning a ‘go to page’ action	57
Sending a document or form via e-mail	58
Hiding a field until a condition is met	59
Working with JavaScript actions	60
Working with document level JavaScript actions	61
Creating form fields programmatically	62
Button	64
Check Box	66
Combo Box	67
List Box	70
Radio Button	71
Signature	72
Text	73
A Short Acrobat JavaScript FAQ	75
Where can JavaScripts be found and how are they used?	75
Folder Level JavaScripts	75
Document level	75
Field level	76
How should I name my form fields?	76
How do I use date objects?	77
Converting from a Date to a String	77
Converting from a string to a date	79
Date arithmetic	79
How can I make my document secure?	81
Restricting Access to the Document	81
Restricting Permissions	81
Digital Signatures	81
How can I make restricted Acrobat JavaScript methods available to users?	82
How can I lock a document after a signature field has been signed?	82
How can I make my documents accessible?	83
Document Metadata	83
Short Description	84
Setting Tab Order	84
Reading Order	84
How can I define globals in JavaScript?	84
Making Globals Persistent	85
How can I send form data to an e-mail address?	85
How can I hide a field based on the value of another?	85
How can I query a field value in another open form from the form I'm working on?	85
How can I intercept keystrokes one by one as they occur?	86
How can I build a nested popup menu?	86
How can I construct my own colors?	86
How can I prompt the user for a response in a dialog?	87
How can I fetch an URL from JavaScript?	87
How can I change the hot-help text for a field dynamically?	87
How can I change the zoom factor programmatically?	87
How can I determine if the mouse has entered/left a certain area?	88

Match case Limit results 1 per page

Acrobat JavaScript Scripting Guide

A Short Acrobat JavaScript FAQ

How do I use date objects?

Converting from a string to a date

To convert a string into a

Date

object the

scand

of the

Util Object

is used. It accepts a

format string that it uses as a hint as to the order of the year, month, and day in the input

string.

/* Example of util.scand */

/* Create some strings containing the same date in differing formats. */

var s1 = "03/12/97";

var s2 = "80/06/01";

var s3 = "December 6, 1948";

var s4 = "Saturday 04/11/76";

var s5 = "Tue. 02/01/30";

var s6 = "Friday, Jan. the 15th, 1999";

/* Convert the strings into Date objects using util.scand */

var d1 = util.scand("mm/dd/yy", s1);

var d2 = util.scand("yy/mm/dd", s2);

var d3 = util.scand("mmmm dd, yyyy", s3);

var d4 = util.scand("mm/dd/yy", s4);

var d5 = util.scand("yy/mm/dd", s5);

var d6 = util.scand("mmmm dd, yyyy", s6);

/* Print the dates to the console using util.printd */

console.println(util.printd("mm/dd/yyyy", d1));

console.println(util.printd("mm/dd/yyyy", d2));

console.println(util.printd("mm/dd/yyyy", d3));

console.println(util.printd("mm/dd/yyyy", d4));

console.println(util.printd("mm/dd/yyyy", d5));

console.println(util.printd("mm/dd/yyyy", d6));

The output of this script would look like:

03/12/1997

06/01/1980

12/06/1948

04/11/1976

01/30/2002

01/15/1999

Unlike the date constructor (new Date(...)),

scand

is rather forgiving in terms of the string

passed to it.

OTE

Given a two digit year for input,

scand

resolves the ambiguity as follows: if the year

is less than 50 then it is assumed to be in the 21st century (i.e. add 2000), if it is

greater than or equal to 50 then it is in the 20th century (add 1900). This heuristic is

often known as the Date Horizon.

Date arithmetic

It is often useful to do arithmetic on dates to determine things like the time interval

between two dates or what the date will be several days or weeks in the future. The

JavaScript

Date

object provides several ways to do this. The simplest and possibly most

easily understood method is by manipulating dates in terms of their numeric