Intl.DateTimeFormat.prototype.formatRangeToParts()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Die formatRangeToParts()-Methode von Intl.DateTimeFormat Instanzen gibt ein Array von lokalisierungsspezifischen Tokens zurück, die jeweils einen Teil des formatierten Datumsbereichs darstellen, der von diesem Intl.DateTimeFormat-Objekt erzeugt wird.

Probieren Sie es aus

Syntax

js
formatRangeToParts(startDate, endDate)

Beispiele

Grundlegende Verwendung von formatRangeToParts

Diese Methode empfängt zwei Dates und gibt ein Array von Objekten zurück, die die lokalisierungsspezifischen Tokens enthalten, die jeweils einen Teil des formatierten Datumsbereichs darstellen.

Hinweis: Die in Ihrer Lokalisierung angezeigten Rückgabewerte können von den unten aufgeführten abweichen.

js
const date1 = new Date(Date.UTC(1906, 0, 10, 10, 0, 0)); // Wed, 10 Jan 1906 10:00:00 GMT
const date2 = new Date(Date.UTC(1906, 0, 10, 11, 0, 0)); // Wed, 10 Jan 1906 11:00:00 GMT

const fmt = new Intl.DateTimeFormat("en", {
  hour: "numeric",
  minute: "numeric",
});

console.log(fmt.formatRange(date1, date2)); // '10:00 – 11:00 AM'

fmt.formatRangeToParts(date1, date2);
// [
//   { type: 'hour',      value: '10',  source: "startRange" },
//   { type: 'literal',   value: ':',   source: "startRange" },
//   { type: 'minute',    value: '00',  source: "startRange" },
//   { type: 'literal',   value: ' – ', source: "shared"     },
//   { type: 'hour',      value: '11',  source: "endRange"   },
//   { type: 'literal',   value: ':',   source: "endRange"   },
//   { type: 'minute',    value: '00',  source: "endRange"   },
//   { type: 'literal',   value: ' ',   source: "shared"     },
//   { type: 'dayPeriod', value: 'AM',  source: "shared"     }
// ]

Spezifikationen

Specification
ECMAScript Internationalization API Specification
# sec-Intl.DateTimeFormat.prototype.formatRangeToParts

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch