欢迎各位兄弟 发布技术文章

这里的技术是共享的

You are here

date-fns parseISO 有大用

parseISO

描述

以ISO 8601格式解析给定的字符串,并返回Date的实例。

函数接受完整的ISO 8601格式以及部分实现。 ISO 8601:http//en.wikipedia.org/wiki/ISO_8601

如果参数不是字符串,则函数无法解析字符串或 值无效,它将返回无效日期。

v2.0.0重大更改:

  • 整个库的常见更改

  • 先前的实现已重命名为parseparseISO

    // v2.0.0之前
    解析'2016-01-01'
    //从v2.0.0开始
    parseISO'2016-01-01'
  • parseISO现在可以验证ISO-8601字符串中的单独日期和时间值, 在日期无效时返回Invalid Date

    parseISO'2018-13-32'
    // =>无效的日期
  • parseISO现在,如果解析字符串参数失败,它就不再依赖于构造函数。而是返回new Date Invalid Date

用法

var  parseISO  =  require'date-fns / parseISO'

句法

parseISO参数,[ 选项 ])

参数

名称类型描述
争论

要转换的值

选项
(可选的)
宾语

具有选项的对象。

属性:
名称类型描述
additionalDigits
(可选,默认为2)
0 | 1 | 2

扩展年份格式中的附加位数

返回

类型描述
日期

本地时区中的解析日期

例外

类型描述
类型错误

需要1个参数

引发RangeError

options.additionalDigits 必须为0、1或2

例子

//将字符串'2014-02-11T11:30:30'转换为日期:
var  结果 =  parseISO'2014-02-11T11:30:30'
// =>星期二,2014年2月11日11:30:30
//将字符串“ +02014101”转换为日期,
//如果扩展年份格式的附加位数为1:
VAR  结果 =  parseISO'02014101',{ additionalDigits1 })
// =>星期五2014年4月11日00:00:00


来自  https://date-fns.org/v2.0.0/docs/parseISO



parseISO

Description

Parse the given string in ISO 8601 format and return an instance of Date.

Function accepts complete ISO 8601 formats as well as partial implementations. ISO 8601: http://en.wikipedia.org/wiki/ISO_8601

If the argument isn't a string, the function cannot parse the string or the values are invalid, it returns Invalid Date.

v2.0.0 breaking changes:

  • Changes that are common for the whole library.

  • The previous parse implementation was renamed to parseISO.

    // Before v2.0.0
    parse('2016-01-01')
    // v2.0.0 onward
    parseISO('2016-01-01')
  • parseISO now validates separate date and time values in ISO-8601 strings and returns Invalid Date if the date is invalid.

    parseISO('2018-13-32')
    //=> Invalid Date
  • parseISO now doesn't fall back to new Date constructor if it fails to parse a string argument. Instead, it returns Invalid Date.

Usage

var parseISO = require('date-fns/parseISO')

Syntax

parseISO(argument, [options])

Arguments

NameTypeDescription
argumentString

the value to convert

options
(optional)
Object

an object with options.

Properties:
NameTypeDescription
additionalDigits
(optional, default=2)
0 | 1 | 2

the additional number of digits in the extended year format

Returns

TypeDescription
Date

the parsed date in the local time zone

Exceptions

TypeDescription
TypeError

1 argument required

RangeError

options.additionalDigits must be 0, 1 or 2

Examples

// Convert string '2014-02-11T11:30:30' to date:
var result = parseISO('2014-02-11T11:30:30')
//=> Tue Feb 11 2014 11:30:30
// Convert string '+02014101' to date,
// if the additional number of digits in the extended year format is 1:
var result = parseISO('+02014101', { additionalDigits: 1 })
//=> Fri Apr 11 2014 00:00:00


来自  https://date-fns.org/v2.0.0/docs/parseISO

普通分类: