S = dat2str(Dat,...)
Dat
[ numeric ] - IRIS serial date number(s).S
[ cellstr ] - Cellstr with strings representing the input dates.'dateFormat='
[ char | cellstr | 'YYYYFP'
] - Date format string, or array of format strings (possibly different for each date).
'freqLetters='
[ char | 'YHQBMW'
] - Six letters used to represent the six possible frequencies of IRIS dates, in this order: yearly, half-yearly, quarterly, bi-monthly, monthly, and weekly (such as the 'Q'
in '2010Q1'
).
'months='
[ cellstr | {'January',...,'December'}
] - Twelve strings representing the names of the twelve months.
'standinMonth='
[ numeric | 'last'
| 1
] - Month that will represent a lower-than-monthly-frequency date if the month is part of the date format string.
'wwDay='
[ 'Mon'
| 'Tue'
| 'Wed'
| 'Thu'
| 'Fri'
| 'Sat'
| 'Sun'
] - Day of week that will represent weeks.
There are two types of date strings in IRIS: year-period strings and calendar date strings. The year-period strings can be printed for dates with yearly, half-yearly, quarterly, bimonthly, monthly, weekly, and indeterminate frequencies. The calendar date strings can be printed for dates with weekly and daily frequencies. Date formats for calendar date strings must start with a dollar sign, $
.
Regular date formats can include any combination of the following fields:
'Y'
- Year.
'YYYY'
- Four-digit year.
'YY'
- Two-digit year.
'P'
- Period within the year (half-year, quarter, bi-month, month, week).
'PP'
- Two-digit period within the year.
'R'
- Upper-case roman numeral for the period within the year.
'r'
- Lower-case roman numeral for the period within the year.
'M'
- Month numeral.
'MM'
- Two-digit month numeral.
'MMMM'
, 'Mmmm'
, 'mmmm'
- Case-sensitive name of month.
'MMM'
, 'Mmm'
, 'mmm'
- Case-sensitive three-letter abbreviation of month.
'Q'
- Upper-case roman numeral for the month or stand-in month.
'q'
- Lower-case roman numeral for the month or stand-in month.
'F'
- Upper-case letter representing the date frequency.
'f'
- Lower-case letter representing the date frequency.
'EE'
- Two-digit end-of-month day; stand-in month used for non-monthly dates.
'E'
- End-of-month day; stand-in month used for non-monthly dates.
'WW'
- Two-digit end-of-month workday; stand-in month used for non-monthly dates.
'W'
- End-of-month workday; stand-in month used for non-monthly dates.
Calendar date formats must start with a dollar sign, $
, and can include any combination of the following fields:
'Y'
- Year.
'YYYY'
- Four-digit year.
'YY'
- Two-digit year.
'DD'
- Two-digit day numeral; daily and weekly dates only.
'D'
- Day numeral; daily and weekly dates only.
'M'
- Month numeral.
'MM'
- Two-digit month numeral.
'MMMM'
, 'Mmmm'
, 'mmmm'
- Case-sensitive name of month.
'MMM'
, 'Mmm'
, 'mmm'
- Case-sensitive three-letter abbreviation of month.
'Q'
- Upper-case roman numeral for the month.
'q'
- Lower-case roman numeral for the month.
'DD'
- Two-digit day numeral.
'D'
- Day numeral.
'Aaa'
, 'AAA'
- Three-letter English name of the day of week ('Mon'
, ..., 'Sun'
).
To get the format letters printed literally in the date string, use a percent sign as an escape character: '%Y'
, '%P'
, '%F'
, '%f'
, '%M'
, '%m'
, '%R'
, '%r'
, '%Q'
, '%q'
, '%D'
, '%E'
, '%D'
.