阿西河

所有教程

公众号
🌙
阿西河前端的公众号

我的收藏

    最近访问  (文章)

      教程列表

      抓包专区
      测试专区

      JS Intl.DateTimeFormat

      Intl.DateTimeFormat 是根据语言来格式化日期和时间的对象的构造器。

      var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
      // Results below assume UTC timezone - your results may vary
      
      console.log(new Intl.DateTimeFormat('en-US').format(date));
      // expected output: "12/20/2012"
      
      console.log(new Intl.DateTimeFormat('en-GB').format(date));
      // expected output: "20/12/2012"
      
      // Include a fallback language, in this case Indonesian
      console.log(new Intl.DateTimeFormat(['ban', 'id']).format(date));
      // expected output: "20/12/2012"
      

      语法

      new Intl.DateTimeFormat([locales[, options]])
      Intl.DateTimeFormat.call(this[, locales[, options]])
      

      参数

      locales

      可选。缩写语言代码 (BCP 47 language tag, 例如:cmn-Hans-CN) 的字符串或者这些字符串组成的数组。关于参数 locales 的一般形式和解释请参见 Intl page. 下面的这些 Unicode 扩展键也是被允许的:

      译者注:下面这两种扩展的使用方式是language-scripts-u-nu-* 和 language-scripts-u-ca-* ,例如:zh-u-nu-hanidec(表示中文十进制数字) 和 zh-u-ca-chinese(表示中国日历,比如壬辰年冬月8日) ,也可以 nu 和 ca 组合使用 比如 使用 zh-u-ca-chinese-nu-hanidec 格式化Date.now()的返回值类似于"丙申年冬月九日"

      nu

      编号系统。可能的值包括:“arab”, “arabext”, “bali”, “beng”, “deva”, “fullwide”, “gujr”, “guru”, “hanidec”, “khmr”, “knda”, “laoo”, “latn”, “limb”, “mlym”, “mong”, “mymr”, “orya”, “tamldec”, “telu”, “thai”, “tibt”.

      ca

      日历。可能的值包括:“buddhist”, “chinese”, “coptic”, “ethioaa”, “ethiopic”, “gregory”, “hebrew”, “indian”, “islamic”, “islamicc”, “iso8601”, “japanese”, “persian”, “roc”.

      options

      可选。包含一些或所有的下面属性的类:

      localeMatcher

      使用的 local 的匹配算法。可能的值有"lookup"和"best fit"; 默认值是 “best fit”. 有关此选项的信息,请参见 Intl page.

      timeZone

      使用的时区。这唯一的值实现必须被标准世界时间 (UTC) 所识别。默认值是运行时的默认时区。IANA time zone database 中的时区名称可能会被识别,例如"Asia/Shanghai", “Asia/Kolkata”, “America/New_York”.

      hour12

      是否使用 12 小时时间制(而不是 24 小时的时间). 可能的值是 true 或 false; 默认值是根据 locale 来自动决定的(译者注:中国地区的默认值为 true).

      formatMatcher

      format 的匹配算法。可能的值有"basic"和"best fit"; 默认值是"best fit". 有关此属性使用的信息,参见以下段落。 日期时间插件被格式化输出时可以使用的属性集合描述。实现需要支持是以下子集中的其中一个(译者注:当 weekday,year 等这些属性一个也不使用的时候,在 cmn-Hans-CN 中相当于使用集合 year, month, day, hour, minute, second 并且它们的值都是 numeric):

      • weekday, year, month, day, hour, minute, second
      • weekday, year, month, day
      • year, month, day
      • year, month
      • month, day
      • hour, minute, second
      • hour, minute

      实现可能支持其他的子集,并通过对所有可用的子集对比找到最匹配的子集。通过 formatMatcher 属性可以设置两种算法用于对比和选择子集:完全匹配"basic"算法 和 一种依赖于“best fit”算法的实现。

      weekday

      工作日的展现方式。可能的值有 “narrow”, “short”, “long”.

      era

      纪元的展现方式。可能的值有 “narrow”, “short”, “long”.

      year

      年的展现方式。可能的值有 “numeric”, “2-digit”.

      month

      月的展现方式。可能的值有 “numeric”, “2-digit”, “narrow”, “short”, “long”.

      day

      日的展现方式。可能的值有 “numeric”, “2-digit”.

      hour

      时的展现方式。可能的值有 “numeric”, “2-digit”.

      minute

      分钟的展现方式。可能的值有 “numeric”, “2-digit”.

      second

      秒的展现方式。可能的值有"numeric", “2-digit”.

      timeZoneName

      时区名称的展现方式。可能的值有 “short”, “long”.

      每个日期时间组件属性的默认值都是 undefined, 但是若所有的组件属性都是 undefined, 那么 year, month, and day 的值就都被认为是"numeric".

      描述

      属性

      Intl.DateTimeFormat.prototype

      允许将属性添加到所有对象上。

      方法

      Intl.DateTimeFormat.supportedLocalesOf()

      Returns an array containing those of the provided locales that are supported without having to fall back to the runtime’s default locale.

      DateTimeFormat 实例

      属性

      DateTimeFormat 实例集成以下原型的属性:

      Intl.DateTimeFormat.prototype.constructor

      A reference to Intl.DateTimeFormat.

      方法

      DateTimeFormat 实例集成以下原型的方法:

      Intl.DateTimeFormat.prototype.format()

      Getter function that formats a date according to the locale and formatting options of this DateTimeFormat object.

      Intl.DateTimeFormat.prototype.formatToParts()

      Returns an Array of objects representing the date string in parts that can be used for custom locale-aware formatting.

      Intl.DateTimeFormat.prototype.resolvedOptions()

      Returns a new object with properties reflecting the locale and formatting options computed during initialization of the object.

      实例

      使用 DateTimeFormat

      不指定 locale 时,DateTimeFormat 使用默认的 locale 和 默认的 options

      var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
      
      //参数未填时使用默认的locale和默认的时区
      console.log(new Intl.DateTimeFormat().format(date));
      //如果是在洛杉矶那么值为 → "12/19/2012"
      

      使用 locales

      这个例子显示了本地化日期和时间格式的一些变化。为了获得用于您的应用程序的用户界面的语言格式,请确保使用 locales 参数确保指定语言(可能还有一些回退语言):

      var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
      
      // 下面是假定的所在时区
      // 洛杉矶(America/Los_Angeles for the US)
      
      // 美式英语(US English) 使用  month-day-year 格式
      console.log(new Intl.DateTimeFormat('en-US').format(date));
      // → "12/19/2012"
      
      // 英式英语(British English) 使用 day-month-year 格式
      console.log(new Intl.DateTimeFormat('en-GB').format(date));
      // → "20/12/2012"
      
      // 韩国使用 year-month-day 格式
      console.log(new Intl.DateTimeFormat('ko-KR').format(date));
      // → "2012. 12. 20."
      
      //大部分阿拉伯国家使用阿拉伯字母(real Arabic digits)
      console.log(new Intl.DateTimeFormat('ar-EG').format(date));
      // → "٢٠‏/١٢‏/٢٠١٢"
      
      //在日本,应用可能想要使用日本日历,
      //2012 是平成24年(平成是是日本天皇明仁的年号,由1989年1月8日起开始计算直至现在)
      console.log(new Intl.DateTimeFormat('ja-JP-u-ca-japanese').format(date));
      // → "平成24/12/20"
      
      //当请求一个语言可能不支持,如巴厘(ban),若有备用的语言印尼语(id),
      //那么将使用印尼语(id)
      console.log(new Intl.DateTimeFormat(['ban', 'id']).format(date));
      // → "20/12/2012"
      

      使用 options

      可以使用 options 参数来自定义 日期时间格式化方法返回的字符串。

      var date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
      
      //请求参数(options)中包含参数星期(weekday),并且该参数的值为长类型(long)
      var options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' };
      console.log(new Intl.DateTimeFormat('de-DE', options).format(date));
      // → "Donnerstag, 20. Dezember 2012"
      
      // 一个应用使用 世界标准时间(UTC),并且UTC使用短名字(short)展示
      options.timeZone = 'UTC';
      options.timeZoneName = 'short';//若不写这一行那么仍然显示的是世界标准时间;但是GMT三个字母不会显示
      console.log(new Intl.DateTimeFormat('en-US', options).format(date));
      // → "Thursday, December 20, 2012, GMT"
      
      // 有时你想变得更精确
      options = {
        hour: 'numeric', minute: 'numeric', second: 'numeric',
        timeZoneName: 'short'
      };
      console.log(new Intl.DateTimeFormat('en-AU', options).format(date));
      // → "2:00:00 pm AEDT"
      
      // 使用24小时制
      options = {
        year: 'numeric', month: 'numeric', day: 'numeric',
        hour: 'numeric', minute: 'numeric', second: 'numeric',
        hour12: false
      };
      console.log(date.toLocaleString('en-US', options));
      // → "12/19/2012, 19:00:00"
      

      规范

      规范版本规范状态注解
      ECMAScript Internationalization API 1.0 (ECMA-402)
      Intl.DateTimeFormat
      StandardInitial definition.
      ECMAScript Internationalization API 2.0 (ECMA-402)
      Intl.DateTimeFormat
      Standard
      ECMAScript Internationalization API 4.0 (ECMA-402)
      Intl.DateTimeFormat
      Draft
      目录
      目录