TZTimeOnly

base: StringFIX 5.0 SP2

TZTimeOnly is a FIX datatype defined in FIX 5.0 SP2, carried on the wire as String. 5 fields use it.

Wire format

Base type
String
Format
HH:MM[:SS][Z|[+|-]hh[:mm]]
Fields
5

Carried on the wire as String.

What the specification says

Time represented based on ISO 8601. This is the time with a UTC offset to allow identification of local time and time zone of that time. Format is HH:MM[:SS][Z | [ + | - hh[:mm]]] where HH = 00-23 hours, MM = 00-59 minutes, SS = 00-59 seconds, hh = 01-12 offset hours, mm = 00-59 offset minutes.

Descriptions are quoted from the FIX Orchestra sources under the Apache 2.0 licence.

How @boarteam/fix handles it

@boarteam/fix keeps the value as a string; format rules are checked by validate(), which reports validate/invalid-value rather than throwing.

Fields with this datatype

TagFieldDialectsMessages
1079MaturityTimeFIX 5.0 SP272
1212LegMaturityTimeFIX 5.0 SP255
1213UnderlyingMaturityTimeFIX 5.0 SP268
1253DerivativeMaturityTimeFIX 5.0 SP23
1405UnderlyingLegMaturityTimeFIX 5.0 SP22

Decode this in your own code

The same engine that produced the decoded example above is an Apache-2.0 npm package with zero runtime dependencies. It runs in Node and in the browser, and parse() returns problems as data instead of throwing.

npm i @boarteam/fix @boarteam/fix-dict-fix44