TimeUtilities.ParseCalendarDate(String, String, String, String, String) Method

Top 

Description

Parses the calendar date in calendarDate as a time in the calendarSystem system using the format specified in calendarFormat and returns its time value in the outputReference system and outputReference reference. The allowed patterns are documented in the "Date and Time Format Specifiers" tables on the "Parsing Dates and Times" page in the Help File. Note that arbitrary text can be included in the pattern by surrounding the text with double asterisks.

 

Timing Precision Mode

This page describes functionality in millisecond timing precision mode. Millisecond timing precision mode is deprecated and will be removed in a future release. We recommend that you migrate your Mission Plans to nanosecond timing precision mode.

Click here to see the documentation for this object in nanosecond timing precision mode.

 

Method Signature

TimeUtilities.ParseCalendarDate(

String calendarDate,


String calendarFormat,


String calendarSystem,


String outputSystem,


String outputReference)

 

 

Arguments

calendarDate


Description:

A String containing a calendar date.

 

 

calendarFormat


Description:

Specifies the format of the input calendarDate. The format specification can include the date and time formats shown in the in the "Date and Time Format Specifiers" tables on the "Parsing Dates and Times" page in the Help File, including month, day, year, hours, minutes, and seconds. The user can also include custom characters by surrounding them with **asterisks**. If a format string is not specified, the format "Mmm DD YYYY hh:mm:ss.fs" will be used.

 

 

calendarSystem


Description:

The time system of calendarDate.

Valid Values:

Value

Label

"TAI"

International Atomic Time

"UTC"

Coordinated Universal Time

"TDT"

Terrestrial Dynamical Time

"TDB"

Barycentric Dynamical Time

"UT1"

Universal Time Principle Form

"GPS"

Global Positioning System Time

 

 

 

outputSystem


Description:

The time system in which to output the parsed value.

Valid Values:

Value

Label

"TAI"

International Atomic Time

"UTC"

Coordinated Universal Time

"TDT"

Terrestrial Dynamical Time

"TDB"

Barycentric Dynamical Time

"UT1"

Universal Time Principle Form

"GPS"

Global Positioning System Time

 

 

 

outputReference


Description:

The time reference relative which to output the parsed value.

Valid Values:

Value

Label

"Julian Date"

Julian Date (Jan 1 4713 BCE 12:00:00.000 TAI)

"MJD GSFC"

GSFC Modified Julian Date (Jan 05 1941 12:00:00.000 TAI)

"MJD USNO"

USNO Modified Julian Date (Nov 17 1858 00:00:00.000 TAI)

"MJD GPS"

GPS Modified Julian Date (Jan 06 1980 00:00:00.000 UTC)

"MJD 1950"

Besselian Date 1950.0 (Dec 31 1949 22:09:46.862 TAI)

 

 

 

 

Return Value

Type:

number

Units:

day

 

 

Returns the parsed calendar date as a time value in the specified system and reference.

 

Syntax

myVariable1 = TimeTools.ParseCalendarDate(myString1, myString2, myString3, myString4, myString5);

 

 

See also

TimeUtilities Object

TimeUtilities.ParseCalendarDate

Parsing Dates and Times