dtl.New()

Syntax

static dtl dtl.New(int years,
int months,
int days,
int hours,
int hours,
int minutes,
int seconds,
int milliseconds)

Parameters

Parameter	Type	Description
years (required)	int	The year portion of the new `dtl` object. Must be a positive integer of up to 9999, inclusive.
months (required)	int	The month portion of the new `dtl` object. Must be a positive integer between 1 and 12, inclusive.
days (required)	int	The day portion of the new `dtl` object. Must be a positive integer between 1 and the number of days in the month determined by the year and month portions.
hours (required)	int	The hour portion of the new `dtl` object. Must be a positive integer between 0 and 24, inclusive.
minutes (required)	int	The minute portion of the new `dtl` object. Must be a positive integer between 0 and 59, inclusive.
seconds (required)	int	The second portion of the new `dtl` object. Must be a positive integer between 0 and 59, inclusive.
milliseconds (required)	int	The millisecond portion of the new `dtl` object. Must be a positive integer between 000 and 999, inclusive.

Returns

A dtl value with the date and time portions that you pass the method.

Remarks

If you pass the method out-of-range parameters, the script throws an error with a message that specifies the valid ranges for the invalid parameter.

The millisecond portion is not displayed when dates are traced to the console.

Sample

dtlSample.rfs

var a = dtl.New(2000, 3, 12, 6, 45, 32, 43);
trace "My cat was born at ", a;

"My cat was born at ", 2000.03.12. 6:45:32 (Dtl)

Figure 353. The trace message output of the script above

Developer Documentation