posixtostrc¶
Purpose¶
Converts a matrix containing dates in POSIX date/time format to a string array, using the BSD strftime format specifiers.
Format¶
-
sa =
posixtostrc
(x, fmt)¶ Parameters: - x (NxK matrix) – dates in POSIX date/time format (seconds since January 1, 1970).
- fmt (string or ExE conformable string array) – contains strftime date/time format characters.
Returns: sa (NxK string array) – dates in POSIX date/time format found in x converted to a string array.
Examples¶
Example 2¶
print posixtostrc(-760771411, "%Y-%m-%d %H:%M:%S");
produces the output:
1945-11-22 18:36:29
Example 3¶
print posixtostrc(97172340, "%B %d, %Y at %l:%M %p");
produces the output:
January 29, 1973 at 4:19 PM
Example 4¶
d = { 1193172342, 1203172342 };
s = posixtostrc(d, "%b %d, %Y");
produces s equal to:
Oct 23, 2007
Feb 16, 2008
Using the same d from above:
s = posixtostrc(d, "%x %X");
produces s equal to:
10/23/07 20:45:42
02/16/08 14:32:22
Continuing with the same x from above:
fmt = "Michael was born on %b %drd, %Y" $| "Jessica was born on %b %dth, %Y";
s = posixtostrc(d, fmt);
produces s equal to:
Michael was born on Oct 23rd, 2007
Jessica was born on Feb 16th, 2008
Remarks¶
The following format specifiers are supported:
%A | The full weekday name. |
%a | The abbreviated weekday name. |
%B | The full month name. |
%b, or %h | The abbreviated month name. |
%C | The century (a year divided by 100 and truncated to an integer) as a decimal number (00-99). |
%c | The locale’s appropriate date and time representation. |
%D | The date format “%m/%d/%y”. |
%d | The day of month as a decimal number (01-31). |
%e | The day of month as a decimal number (1-31); single digits are preceded by a blank. |
%F | The date format “%Y-%m-%d”. |
%G | The ISO 8601 year with century as a decimal number. |
%g | The ISO 8601 year without century as a decimal number (00-99). |
%H | The hour (24-hour clock) as a decimal number (00-23). |
%I | The hour (12-hour clock) as a decimal number (01-12). |
%j | The day of the year as a decimal number (001-366). |
%k | The hour (24-hour clock) as a decimal number (0-23); single digits are preceded by a blank. |
%l | The hour (12-hour clock) as a decimal number (1-12); single digits are preceded by a blank. |
%M | The minute as a decimal number (00-59). |
%m | The month as a decimal number (01-12). |
%n | A newline. |
%p | The locale’s equivalent of either “AM” or “PM”. |
%R | The time in the format “%H:%M”. |
%r | The locale’s representation of 12-hour clock time using AM/PM notation. |
%S | The second as a decimal number (00-60). The range of seconds is (00-60) instead of (00-59) to allow for the periodic occurrence of leap seconds. |
%s | The number of seconds since the Epoch, UTC. |
%T | The time in the format “%H:%M:%S”. |
%t | A tab. |
%U | The week number of the year (Sunday as the first day of the week) as a decimal number (00-53). |
%u | The weekday (Monday as the first day of the week) as a decimal number (1-7). |
%V | The week number of the year (Monday as the first day of the week) as a decimal number (01-53). If the week containing January 1 has four or more days in the new year, then it is week 1; otherwise it is week 53 of the previous year, and the next week is week 1. |
%v | The date in the format “%e-%b-%Y”. |
%W | The week number of the year (Monday as the first day of the week) as a decimal number (00-53). |
%w | The weekday (Sunday as the first day of the week) as a decimal number (0-6). |
%X | The locale’s appropriate time representation. |
%x | The locale’s appropriate date representation. |
%Y | The year with century as a decimal number. |
%y | The year without century as a decimal number (00-99). |
%q | The quarter of the year. (1-4) |
%Z | The time zone name, or by the empty string if this is not determinable. |
%% | The ‘%’ sign. |
See also
Functions dttostrc()
, strctodt()
, strctoposix()
, dttostr()
, strtodt()
, dttoutc()
, utctodt()