luxon
Version:
Immutable date wrapper
437 lines (404 loc) • 16.5 kB
HTML
<html>
<head>
<meta charset="utf-8">
<base data-ice="baseUrl" href="../../../">
<title data-ice="title">Luxon</title>
<link type="text/css" rel="stylesheet" href="css/style.css">
<link type="text/css" rel="stylesheet" href="css/prettify-tomorrow.css">
<script src="script/prettify/prettify.js"></script>
<script src="script/manual.js"></script>
<link data-ice="userStyle" rel="stylesheet" href="user/css/0-styles.css">
</head>
<body class="layout-container" data-ice="rootContainer">
<header><span class="luxon-title">Luxon</span>
<a href="./">Home</a>
<a href="identifiers.html">Reference</a>
<a href="source.html">Source</a>
<a data-ice="repoURL" href="https://github.com/icambron/luxon" class="repo-url-github">Repository</a>
<div class="search-box">
<span>
<img src="./image/search.png">
<span class="search-input-edge"></span><input class="search-input"><span class="search-input-edge"></span>
</span>
<ul class="search-result"></ul>
</div>
</header>
<nav class="navigation" data-ice="nav"><div>
<ul>
<li data-ice="doc"><span data-ice="kind" class="kind-class">C</span><span data-ice="name"><span><a href="class/src/datetime.js~DateTime.html">DateTime</a></span></span></li>
<li data-ice="doc"><span data-ice="kind" class="kind-class">C</span><span data-ice="name"><span><a href="class/src/duration.js~Duration.html">Duration</a></span></span></li>
<li data-ice="doc"><span data-ice="kind" class="kind-class">C</span><span data-ice="name"><span><a href="class/src/info.js~Info.html">Info</a></span></span></li>
<li data-ice="doc"><span data-ice="kind" class="kind-class">C</span><span data-ice="name"><span><a href="class/src/interval.js~Interval.html">Interval</a></span></span></li>
<li data-ice="doc"><span data-ice="kind" class="kind-class">C</span><span data-ice="name"><span><a href="class/src/settings.js~Settings.html">Settings</a></span></span></li>
<li data-ice="doc"><span data-ice="kind" class="kind-interface">I</span><span data-ice="name"><span><a href="class/src/zone.js~Zone.html">Zone</a></span></span></li>
</ul>
</div>
</nav>
<div class="content" data-ice="content"><h1 data-ice="title">src/impl/formatter.js</h1>
<pre class="source-code line-number raw-source-code"><code class="prettyprint linenums" data-ice="content">import { Util } from './util';
import { DateTime } from '../datetime';
import { English } from './english';
function stringifyTokens(splits, tokenToString) {
let s = '';
for (const token of splits) {
if (token.literal) {
s += token.val;
} else {
s += tokenToString(token.val);
}
}
return s;
}
/**
* @private
*/
export class Formatter {
static create(locale, opts = {}) {
const formatOpts = Object.assign({}, { round: true }, opts);
return new Formatter(locale, formatOpts);
}
static parseFormat(fmt) {
let current = null,
currentFull = '',
bracketed = false;
const splits = [];
for (let i = 0; i < fmt.length; i++) {
const c = fmt.charAt(i);
if (c === "'") {
if (currentFull.length > 0) {
splits.push({ literal: bracketed, val: currentFull });
}
current = null;
currentFull = '';
bracketed = !bracketed;
} else if (bracketed) {
currentFull += c;
} else if (c === current) {
currentFull += c;
} else {
if (currentFull.length > 0) {
splits.push({ literal: false, val: currentFull });
}
currentFull = c;
current = c;
}
}
if (currentFull.length > 0) {
splits.push({ literal: bracketed, val: currentFull });
}
return splits;
}
constructor(locale, formatOpts) {
this.opts = formatOpts;
this.loc = locale;
}
formatDateTime(dt, opts = {}) {
const [df, d] = this.loc.dtFormatter(dt, Object.assign({}, this.opts, opts));
return df.format(d);
}
formatDateTimeParts(dt, opts = {}) {
const [df, d] = this.loc.dtFormatter(dt, Object.assign({}, this.opts, opts));
return df.format(d);
}
resolvedOptions(dt, opts = {}) {
const [df, d] = this.loc.dtFormatter(dt, Object.assign({}, this.opts, opts));
return df.resolvedOptions(d);
}
num(n, p = 0) {
const opts = Object.assign({}, this.opts);
if (p > 0) {
opts.padTo = p;
}
return this.loc.numberFormatter(opts).format(n);
}
formatDateTimeFromString(dt, fmt) {
const knownEnglish = this.loc.listingMode() === 'en';
const string = (opts, extract) => this.loc.extract(dt, opts, extract),
formatOffset = opts => {
if (dt.isOffsetFixed && dt.offset === 0 && opts.allowZ) {
return 'Z';
}
const hours = Util.towardZero(dt.offset / 60),
minutes = Math.abs(dt.offset % 60),
sign = hours >= 0 ? '+' : '-',
base = `${sign}${Math.abs(hours)}`;
switch (opts.format) {
case 'short':
return `${sign}${this.num(Math.abs(hours), 2)}:${this.num(minutes, 2)}`;
case 'narrow':
return minutes > 0 ? `${base}:${minutes}` : base;
case 'techie':
return `${sign}${this.num(Math.abs(hours), 2)}${this.num(minutes, 2)}`;
default:
throw new RangeError(`Value format ${opts.format} is out of range for property format`);
}
},
meridiem = () =>
knownEnglish
? English.meridiemForDateTime(dt)
: string({ hour: 'numeric', hour12: true }, 'dayperiod'),
month = (length, standalone) =>
knownEnglish
? English.monthForDateTime(dt, length)
: string(standalone ? { month: length } : { month: length, day: 'numeric' }, 'month'),
weekday = (length, standalone) =>
knownEnglish
? English.weekdayForDateTime(dt, length)
: string(
standalone ? { weekday: length } : { weekday: length, month: 'long', day: 'numeric' },
'weekday'
),
era = length =>
knownEnglish ? English.eraForDateTime(dt, length) : string({ era: length }, 'era'),
tokenToString = token => {
const outputCal = this.loc.outputCalendar;
// Where possible: http://cldr.unicode.org/translation/date-time#TOC-Stand-Alone-vs.-Format-Styles
switch (token) {
// ms
case 'S':
return this.num(dt.millisecond);
case 'SSS':
return this.num(dt.millisecond, 3);
// seconds
case 's':
return this.num(dt.second);
case 'ss':
return this.num(dt.second, 2);
// minutes
case 'm':
return this.num(dt.minute);
case 'mm':
return this.num(dt.minute, 2);
// hours
case 'h':
return this.num(dt.hour === 12 ? 12 : dt.hour % 12);
case 'hh':
return this.num(dt.hour === 12 ? 12 : dt.hour % 12, 2);
case 'H':
return this.num(dt.hour);
case 'HH':
return this.num(dt.hour, 2);
// offset
case 'Z':
// like +6
return formatOffset({ format: 'narrow', allowZ: true });
case 'ZZ':
// like +06:00
return formatOffset({ format: 'short', allowZ: true });
case 'ZZZ':
// like +0600
return formatOffset({ format: 'techie', allowZ: false });
case 'ZZZZ':
// like EST
return dt.offsetNameShort;
case 'ZZZZZ':
// like Eastern Standard Time
return dt.offsetNameLong;
// zone
case 'z':
return dt.zoneName;
// like America/New_York
// meridiems
case 'a':
return meridiem();
// dates
case 'd':
return outputCal ? string({ day: 'numeric' }, 'day') : this.num(dt.day);
case 'dd':
return outputCal ? string({ day: '2-digit' }, 'day') : this.num(dt.day, 2);
// weekdays - standalone
case 'c':
// like 1
return this.num(dt.weekday);
case 'ccc':
// like 'Tues'
return weekday('short', true);
case 'cccc':
// like 'Tuesday'
return weekday('long', true);
case 'ccccc':
// like 'T'
return weekday('narrow', true);
// weekdays - format
case 'E':
// like 1
return this.num(dt.weekday);
case 'EEE':
// like 'Tues'
return weekday('short', false);
case 'EEEE':
// like 'Tuesday'
return weekday('long', false);
case 'EEEEE':
// like 'T'
return weekday('narrow', false);
// months - standalone
case 'L':
// like 1
return outputCal
? string({ month: 'numeric', day: 'numeric' }, 'month')
: this.num(dt.month);
case 'LL':
// like 01, doesn't seem to work
return outputCal
? string({ month: '2-digit', day: 'numeric' }, 'month')
: this.num(dt.month, 2);
case 'LLL':
// like Jan
return month('short', true);
case 'LLLL':
// like January
return month('long', true);
case 'LLLLL':
// like J
return month('narrow', true);
// months - format
case 'M':
// like 1
return outputCal ? string({ month: 'numeric' }, 'month') : this.num(dt.month);
case 'MM':
// like 01
return outputCal ? string({ month: '2-digit' }, 'month') : this.num(dt.month, 2);
case 'MMM':
// like Jan
return month('short', false);
case 'MMMM':
// like January
return month('long', false);
case 'MMMMM':
// like J
return month('narrow', false);
// years
case 'y':
// like 2014
return outputCal ? string({ year: 'numeric' }, 'year') : this.num(dt.year);
case 'yy':
// like 14
return outputCal
? string({ year: '2-digit' }, 'year')
: this.num(dt.year.toString().slice(-2), 2);
case 'yyyy':
// like 0012
return outputCal ? string({ year: 'numeric' }, 'year') : this.num(dt.year, 4);
// eras
case 'G':
// like AD
return era('short');
case 'GG':
// like Anno Domini
return era('long');
case 'GGGGG':
return era('narrow');
case 'kk':
return this.num(dt.weekYear.toString().slice(-2), 2);
case 'kkkk':
return this.num(dt.weekYear, 4);
case 'W':
return this.num(dt.weekNumber);
case 'WW':
return this.num(dt.weekNumber, 2);
case 'o':
return this.num(dt.ordinal);
case 'ooo':
return this.num(dt.ordinal, 3);
// macros
case 'D':
return this.formatDateTime(dt, DateTime.DATE_SHORT);
case 'DD':
return this.formatDateTime(dt, DateTime.DATE_MED);
case 'DDD':
return this.formatDateTime(dt, DateTime.DATE_FULL);
case 'DDDD':
return this.formatDateTime(dt, DateTime.DATE_HUGE);
case 't':
return this.formatDateTime(dt, DateTime.TIME_SIMPLE);
case 'tt':
return this.formatDateTime(dt, DateTime.TIME_WITH_SECONDS);
case 'ttt':
return this.formatDateTime(dt, DateTime.TIME_WITH_SHORT_OFFSET);
case 'tttt':
return this.formatDateTime(dt, DateTime.TIME_WITH_LONG_OFFSET);
case 'T':
return this.formatDateTime(dt, DateTime.TIME_24_SIMPLE);
case 'TT':
return this.formatDateTime(dt, DateTime.TIME_24_WITH_SECONDS);
case 'TTT':
return this.formatDateTime(dt, DateTime.TIME_24_WITH_SHORT_OFFSET);
case 'TTTT':
return this.formatDateTime(dt, DateTime.TIME_24_WITH_LONG_OFFSET);
case 'f':
return this.formatDateTime(dt, DateTime.DATETIME_SHORT);
case 'ff':
return this.formatDateTime(dt, DateTime.DATETIME_MED);
case 'fff':
return this.formatDateTime(dt, DateTime.DATETIME_FULL);
case 'ffff':
return this.formatDateTime(dt, DateTime.DATETIME_HUGE);
case 'F':
return this.formatDateTime(dt, DateTime.DATETIME_SHORT_WITH_SECONDS);
case 'FF':
return this.formatDateTime(dt, DateTime.DATETIME_MED_WITH_SECONDS);
case 'FFF':
return this.formatDateTime(dt, DateTime.DATETIME_FULL_WITH_SECONDS);
case 'FFFF':
return this.formatDateTime(dt, DateTime.DATETIME_HUGE_WITH_SECONDS);
default:
return token;
}
};
return stringifyTokens(Formatter.parseFormat(fmt), tokenToString);
}
formatDuration() {}
formatDurationFromString(dur, fmt) {
const tokenToField = token => {
switch (token[0]) {
case 'S':
return 'millisecond';
case 's':
return 'second';
case 'm':
return 'minute';
case 'h':
return 'hour';
case 'd':
return 'day';
case 'M':
return 'month';
case 'y':
return 'year';
default:
return null;
}
},
tokenToString = lildur => token => {
const mapped = tokenToField(token);
if (mapped) {
return this.num(lildur.get(mapped), token.length);
} else {
return token;
}
},
tokens = Formatter.parseFormat(fmt),
realTokens = tokens.reduce(
(found, { literal, val }) => (literal ? found : found.concat(val)),
[]
),
collapsed = dur.shiftTo(...realTokens.map(tokenToField).filter(t => t));
return stringifyTokens(tokens, tokenToString(collapsed));
}
}
</code></pre>
</div>
<footer class="footer">
Generated by <a href="https://esdoc.org">ESDoc<span data-ice="esdocVersion">(0.5.2)</span><img src="./image/esdoc-logo-mini-black.png"></a>
</footer>
<script src="script/search_index.js"></script>
<script src="script/search.js"></script>
<script src="script/pretty-print.js"></script>
<script src="script/inherited-summary.js"></script>
<script src="script/test-summary.js"></script>
<script src="script/inner-link.js"></script>
<script src="script/patch-for-local.js"></script>
</body>
</html>