$N8601EHw.d Format

Writes ISO 8601 duration, datetime, and interval forms by using the extended notations Pyyyy-mm-ddThh:mm:ss and yyyy-mm-ddThh:mm:ss, using a hyphen ( - ) for omitted components.

Categories: Date and Time
ISO 8601
Restriction: UTC time zone offset values are not supported.
Supports: ISO 8601 Element 5.4.4, complete representation

Syntax

$N8601EHw.d

Syntax Description

w

specifies the width of the output 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 lowest-order component. This argument is optional.

Default 0
Range 0–3

Details

The $N8601EH format writes ISO 8601 duration, datetime, and interval values as character data, using a hyphen ( - ) to represent omitted components, for the following extended notations:
  • Pyyyy-mm-ddThh:mm:ss
  • yyyy-mm-ddThh:mm:ss
  • Pyyyy-mm-ddThh:mm:ss/yyyy-mm-ddThh:mm:ss
  • yyyy-mm-ddThh:mm:ss/Pyyyy-mm-ddThh:mm:ss
  • yyyy-mm-ddThh:mm:ss/yyyy-mm-ddThh:mm:ss
Omitted datetime components are always displayed; they are never truncated.

Example

put a $n8601eh.;
Value of a
Result
00023FFFFFFFFFFC2012FFF15FFFFFFD
P0002-03—T-:-:-/2012——T15:-:-
2012FFF15FFFFFFdFFFF3FF1553FFFFC
2012--T15:-:-/P—03—T15:53:-