Difference between revisions of "Working With Date and Time Data in Recital"

Revision as of 17:08, 14 January 2010 (view source) Yvonnemilne (Talk | contribs) (→‎Working With Date and Time Data in Recital) ← Older edit		Revision as of 17:11, 14 January 2010 (view source) Yvonnemilne (Talk | contribs) (→‎Working With Date and Time Data in Recital) Newer edit →
Line 13:		Line 13:
	</pre>		</pre>
−	* [[SET EPOCH|set epoch]]	+	* [[SET EPOCH|set epoch]] - specify a one hundred-year epoch to allow for two digit years
−	* [[SET MARK|set mark]]	+
		+	<pre>
		+	set epoch to <start-year as numeric>
		+	</pre>
		+
		+	* [[SET MARK|set mark]] - specify the separator character in dates
		+
		+	<pre>
		+	set mark to [<separator as character>]
		+	</pre>
	===Date and Time Conversion Functions===		===Date and Time Conversion Functions===

---

Revision as of 17:11, 14 January 2010

Working With Date and Time Data in Recital

Certain set commands change the date format:

• set century - enable or disable inclusion of the century

set century on | off

• set date - define the date format

set date [to] american | ansi | british | dmy | french | german | iso | italian | japan | mdy | usa | ymd

• set epoch - specify a one hundred-year epoch to allow for two digit years

set epoch to <start-year as numeric>

• set mark - specify the separator character in dates

set mark to [<separator as character>]

Date and Time Conversion Functions

• ctod() - perform character to date conversion

date = ctod(string as character)

• ctot() - perform character to datetime conversion

datetime = ctot(string as character)

• date() - perform numeric year, month , day to date conversion

date = date(year as numeric, month as numeric, day as numeric)

• datetime() - perform numeric year, month, day to datetime conversion

datetime = datetime(year as numeric, month as numeric, day as numeric)

• days() - perform numeric seconds to numeric whole days conversion

numeric = days(seconds as numeric)

• dmy() - perform date to character (DMY) conversion

string = dmy(date as date)

• dtoc() - perform date to character conversion

string = dtoc(date as date)

• dtom() - perform date to string (DD-Mmm-YYYY) conversion

string = dtom(date as date)

• dtos() - perform date to string conversion

string = dtos(date as date)

• mdy() - perform date to character (MDY) conversion

string = mdy(date as date)

• mtod() - perform string (DD-Mmm-YYYY) to date conversion

date = mtod(string as character)

• stod() - perform string to date conversion

date = stod(string as character)

• tstring() - perform numeric seconds to time string conversion

string = tstring(seconds as numeric)

• ttoc() - perform datetime to string conversion

string = ttoc(datetime as datetime)

• ttod() - perform datetime to date conversion

date = ttod(datetime as datetime)

Miscellaneous Date and Time Functions

• ampm() - return 12-hour clock time as a character string followed by "am" or "pm"
• cdow() - return the character day of week from a date or datetime
• cmonth() - return the character month from a date or datetime
• date() - return the system date as a date
• datetime() - return the system date and time as a datetime
• day() - return the numeric day of the month from a date or datetime
• dow() - return the numeric day of the week from a date or datetime
• elaptime() - return time difference between two time strings as a time string
• epoch() - return the current set epoch setting
• gomonth() - return a date a specified number of months before or after a date or datetime
• hour() - return the numeric hours from a datetime
• hours() - return the numeric hours from a time string
• minute() - return the numeric minutes from a datetime
• minutes() - return the numeric minutes from a time string
• month() - return the numeric month from a date or datetime
• quarter() - return the numeric year quarter from a date or datetime
• sec() - return the numeric seconds from a datetime
• seconds() - return the numeric seconds from the current time or a time string
• secs() - return the numeric seconds from a time string
• time() - return the system time as a time string
• timestamp() - return the system date and time
• validtime() - check the validity of a time string
• week() - return the numeric week from a date or datetime
• year() - return the numeric year from a specified date or datetime