TimeUtilities.ConvertToCalendarDate(Variable, String, String, String) Method

Top 

Description

Returns a calendar String in the format specified by calendarFormat of the date and time represented by the input time value. 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.ConvertToCalendarDate(

Variable time,


String timeSystem,


String timeReference,


String calendarFormat)

 

 

Arguments

time


Description:

The time to convert to a calendar date.

Units:

day

 

 

timeSystem


Description:

The system of the input time.

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

 

 

 

timeReference


Description:

The reference of the input time.

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)

 

 

 

calendarFormat


Description:

Specifies the format of the output String. 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.

 

 

 

Return Value

Type:

string

 

 

Returns a formatted calendar String of the date and time represented by the input time value.

 

Syntax

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

 

 

See also

TimeUtilities Object

TimeUtilities.ConvertToCalendarDate

Parsing Dates and Times