Spacecraft.EpochFormat(String, String) Method

Top 

Description

Returns a formatted string representing an epoch in time. The format string formatSpecification can include the date and time formats shown in the "Parsing Dates and Times" reference in the Help File, including month, day, year, hours, minutes, and seconds. The conversion string timeFrameConversion specifies the time system conversion that is applied. For example, for a calling Spacecraft Epoch in TAI, and an output String in UT1 time, the timeFrameConversion would be "TAI-UT1".

 

This method has been Deprecated. Please use Spacecraft.Epoch.EpochFormat instead.

 

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.

 

Method Signature

Spacecraft.EpochFormat(

String formatSpecification,


String timeFrameConversion)

 

 

Arguments

formatSpecification


Description:

Specifies the format of the output String. The format specification can include the date and time formats shown in the "Parsing Dates and Times" reference 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.

 

 

timeFrameConversion


Description:

Specifies the time system to convert to. If only one time system is specified (e.g., "UT1"), then "UTC-" is prepended to the conversion string (e.g., "UTC-UT1").

Valid Values:

Value

Label

"TAI"

TAI

"UT1"

UT1

"UTC"

UTC

"UTC-UTC"

UTC-UTC

"UTC-TAI"

UTC-TAI

"UTC-UT1"

UTC-UT1

"TAI-TAI"

TAI-TAI

"TAI-UT1"

TAI-UT1

"TAI-UTC"

TAI-UTC

"UT1-UT1"

UT1-UT1

"UT1-TAI"

UT1-TAI

"UT1-UTC"

UT1-UTC

 

 

 

 

Return Value

Type:

string

 

 

Returns a formatted string representing an epoch in time.

 

Syntax

myString1 = mySpacecraft1.EpochFormat(myString2, myString3);

 

 

See also

Spacecraft Object

Spacecraft.EpochFormat

Parsing Dates and Times

Spacecraft Propagation Guide

Coverage and Contact Analysis Guide