$N8601Bw.d Informat

Reads complete, truncated, and omitted forms of ISO 8601 duration, datetime, and interval values that are specified in either the basic or extended notations.
Categories: Date and Time

ISO 8601

Alignment: left
Restriction: UTC time zone offset values are not supported.
Supports: ISO 8601 Element 5.4.4, complete representation

Syntax

$N8601Bw.d

Syntax Description

w
specifies the width of the input field.
Default:50
Range:1–200
Requirement:The minimum length for a duration value or a datetime value is 16. The minimum length for an interval value is 16.
d
specifies the number of digits to the right of the decimal point in the seconds value. This argument is optional.
Default:0
Range:0–3

Details

The $N8601B informat reads ISO 8601 duration, interval, and datetime values as character data for the following basic notations:
Time Component
ISO 8601 Notation
Example
Duration
Pyyyy-mm-ddThh:mm:ss.fff
P2012-09-15T15:53:00
PyyyymmddThhmmss
P00020304T050607
PnYnMnDTnHnMn.fffS
P2y10m14dT20h13m45.222s
PnW
P6w
Interval
yyyy-mm-ddThh:mm:ss.fff/yyyy-mm-ddThh:mm:ss.fff
2012-09-15T15:53:00/2014-11-13T00:00:00
yyyymmddThhmmss.fff/yyyymmddThhmmss.fff
20120915T155300/20141115T120000
PnYnMnDTnHnMn.fffS/yyyy-mm-ddThh:mm:ss.fff
P2y10M14dT20h13m45s/2012-09-15T15:53:00
yyyy-mm-ddThh:mm:ss.fff/PnYnMnDTnHnMn.fffS
2012-09-15T15:53:00/P2y10M14dT20h13m45s
Datetime
yyyy-mm-ddThh:mm:ss.fff
2012-09-15T15:53:00
yyyymmddThhmmss.fff
20120915T155300
The $N8601B informat also reads ISO 8601 duration, interval, and datetime components that contain omitted or truncated components. Omitted components must use a single hyphen ( - ) to represent the component.

Comparisons

The $N8601B informat reads durations, intervals, and datetimes that are specified in either the basic or extended notation.
The $N8601E informat reads durations, intervals, and datetimes that are specified only in the extended notation. Use the $N8601E informat when you need to ensure compliance with the extended notation.

Example

input @1 i860 $n8601b.;
Data Line
Result
p0002-04-05t5:1:12
0002405050112FFC
2012-09-15T15:53:00/2010-09-15T00:00:00
2012915155300FFD2010915000000FFD
p0033-01-04T3:2:55/2012-09-15T15:53:00
0033104030255FFC2012915155300FFD