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 String Epoch in UTC, and an output String in UT1 time, the timeFrameConversion would be "UTC-UT1".
This method has been Deprecated. Please use String.EpochScan.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
String.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
Returns a formatted string representing an epoch in time.
Syntax
myString1 = myString2.EpochFormat(myString3, myString4);
|
For a String containing epoch 02 February 2020, 5:02, UTC:
String String1 = "Feb 02 2020 05:02:00.000";
Report String1.EpochFormat("**Date is: **D Mmmm YY **at time** h12:mm am/pm","UTC");
|
Output Report:
Date is: 2 February 20 at time 5:02 am
|
Note: EpochFormat allows you to embed text within the date and time format using **asterisks**
|
See also
String Object
String.EpochFormat
Parsing Dates and Times
Parsing Dates and Times
Parsing Arbitrary String Data
Parsing Arbitrary String Data
|