Date Decoders

const date: Decoder<Date>

import { date } from 'decoders';

date.decode(new Date());                    // ✓ Date instance
date.decode('2024-01-15T12:00:00Z');        // ✗ Error: Must be a Date
date.decode(1705320000000);                 // ✗ Error: Must be a Date

const isoDateString: Decoder<string>

import { isoDateString } from 'decoders';

isoDateString.decode('2024-01-15T12:00:00Z');         // ✓ '2024-01-15T12:00:00Z'
isoDateString.decode('2024-01-15T12:00:00+05:30');    // ✓ '2024-01-15T12:00:00+05:30'
isoDateString.decode('2024-01-15T12:00:00.123Z');     // ✓ with milliseconds
isoDateString.decode('2024-01-15');                   // ✗ Error: Must be ISO8601 format
isoDateString.decode('9999-99-99T99:99:99Z');        // ✗ Error: Must be valid date/time value

const isoDate: Decoder<Date>

import { isoDate } from 'decoders';

const result = isoDate.decode('2024-01-15T12:00:00Z');
// ✓ Date instance: Mon Jan 15 2024 12:00:00 GMT+0000

isoDate.decode('not a date');  // ✗ Error: Must be ISO8601 format

const flexDate: Decoder<Date>

import { flexDate } from 'decoders';

flexDate.decode(new Date());                   // ✓ Date instance
flexDate.decode('2024-01-15T12:00:00Z');       // ✓ Date instance
flexDate.decode(1705320000000);                // ✗ Error: Must be a Date or date string

import { object, flexDate } from 'decoders';

const eventDecoder = object({
  name: string,
  startDate: flexDate,
});

// Works with JSON payloads
eventDecoder.decode({
  name: 'Conference',
  startDate: '2024-01-15T12:00:00Z'
});

// Also works with Date instances
eventDecoder.decode({
  name: 'Conference',
  startDate: new Date('2024-01-15T12:00:00Z')
});

const iso8601: Decoder<Date>

import { iso8601 } from 'decoders';

iso8601.decode('2024-01-15T12:00:00Z');  // ✓ Date instance

const dateString: Decoder<string>

const datelike: Decoder<Date>