Add isISOMatch function

Suggest adding isISOMatch function, used for validating a date string is in ISO 8601 format.

Options similar to the output of formatISO would be used to further restrict the validateion

The usages of this function is similar to the isMatch function, except where stringent ISO formatting should be used. In my personal use case I would use the

isISOMatch(dateString, { representation: 'date' })

to validate ISO date strings as parameters to an API.

This is in line with other ISO specific functions, such as:

• parse -> parseISO
• format -> formatISO
• formatDuration -> formatISODuration

In line with formatDuration -> formatISODuration, it is more natural to go with isISOMatch than isMatchISO another option could be isISO though I believe this would cause more confusion and is not in line with the existing api.

Usage

// CommonJS
var isISOMatch = require('date-fns/isISOMatch')
// ES 2015
import isISOMatch from 'date-fns/isISOMatch'
// ESM
import { isISOMatch } from 'date-fns'

Syntax

isISOMatch(dateString, [options]);

Arguments

Name	Type	Description
dateString	String	The date string to verify
options	Object	An object with options

Options

Name	Type	Description
representation (optional, default=‘complete’)	‘complete’ | ‘date’ | ‘time’	match date, time with time zone, or both

Returns

Type	Description
Boolean	is the date string an ISO date string

[Liam-Tait]

@lielfr This is just a feature suggestion atm. Suggest waiting for the maintainers to respond

cc: @tan75

[lielfr]

@klokar Thanks. Unfortunately I’ve been busy with uni stuff. Should’ve written about it sooner, sorry about that.