@digitalwalletcorp/utils 0.10.0 → 0.12.0

package/src/date-util.ts

@@ -1,8 +1,10 @@
-import { DateTime, Duration as LuxonDuration } from 'luxon';
-import type { DateTimeUnit } from 'luxon';
+import { ZonedDateTime } from './zoned-date-time';
 
-/** 日時として解釈する値。string はISO形式または inputFormat の書式、number は epoch ミリ秒 */
-export type DateInput = string | Date | number | null | undefined;
+/**
+ * 日時として解釈する値。string はISO形式または inputFormat の書式、number は epoch ミリ秒
+ * ZonedDateTime は inputTimezone を省略した場合、その ZonedDateTime のタイムゾーンで扱う
+ */
+export type DateInput = string | Date | number | ZonedDateTime | null | undefined;
 
 /** 日時の切り捨て(startOf / endOf)に使う単位 */
 export type DateUnit = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second' | 'millisecond';
@@ -37,6 +39,8 @@ export interface ParseDateOptions {
   startOf?: DateUnit;
   /** 指定した単位の最後の時点に切り上げる(month なら月末の23:59:59.999) */
   endOf?: DateUnit;
+  /** 書式の月名・曜日名を解釈・出力するときのロケール。既定は 'en-US' */
+  locale?: string;
 }
 
 /**
@@ -119,65 +123,13 @@ const DEFAULT_TIMEZONE_ABBREVIATIONS: TimezoneAbbreviations = {
   'America/Sao_Paulo': { standard: 'BRT' }
 };
 
-/**
- * タイムゾーンの指定が不正な場合は、日時の不正とは区別して例外にする
- */
-const assertZone = (d: DateTime): void => {
-  if (!d.isValid && d.invalidReason === 'unsupported zone') {
-    throw new RangeError(d.invalidExplanation ?? d.invalidReason);
-  }
-};
-
-const toDateTime = (value: DateInput, options?: ParseDateOptions): DateTime | null => {
-  if (value == null || value === '') {
-    return null;
-  }
-  const zone = options?.inputTimezone ?? DEFAULT_TIMEZONE;
-  let d: DateTime | null = null;
-  if (value instanceof Date) {
-    d = DateTime.fromJSDate(value, { zone: zone });
-  } else if (typeof value === 'number') {
-    d = Number.isFinite(value) ? DateTime.fromMillis(value, { zone: zone }) : null;
-  } else {
-    const formats = options?.inputFormat ? [options.inputFormat].flat() : [];
-    for (const format of formats) {
-      const parsed = DateTime.fromFormat(value, format, { zone: zone });
-      assertZone(parsed);
-      if (parsed.isValid) {
-        d = parsed;
-        break;
-      }
-    }
-    if (d == null) {
-      d = DateTime.fromISO(value, { zone: zone });
-    }
-  }
-  if (d == null) {
-    return null;
-  }
-  assertZone(d);
-  if (!d.isValid) {
-    return null;
-  }
-  if (options?.duration) {
-    d = d.plus(options.duration);
-  }
-  if (options?.startOf) {
-    d = d.startOf(options.startOf);
-  }
-  if (options?.endOf) {
-    d = d.endOf(options.endOf);
-  }
-  return d;
-};
-
 const compare = (date1: DateInput, date2: DateInput, options: ParseDateOptions | undefined, predicate: (v1: number, v2: number) => boolean): boolean => {
-  const d1 = toDateTime(date1, options);
-  const d2 = toDateTime(date2, options);
+  const d1 = ZonedDateTime.parse(date1, options);
+  const d2 = ZonedDateTime.parse(date2, options);
   if (!d1 || !d2) {
     return false;
   }
-  return predicate(d1.valueOf(), d2.valueOf());
+  return predicate(d1.toMillis(), d2.toMillis());
 };
 
 /**
@@ -190,7 +142,7 @@ const compare = (date1: DateInput, date2: DateInput, options: ParseDateOptions |
  * @returns {Date | null}
  */
 export function parseDate(value: DateInput, options?: ParseDateOptions): Date | null {
-  return toDateTime(value, options)?.toJSDate() ?? null;
+  return ZonedDateTime.parse(value, options)?.toDate() ?? null;
 }
 
 /**
@@ -206,19 +158,18 @@ export function parseDate(value: DateInput, options?: ParseDateOptions): Date |
 export function formatDate(options: FormatDateOptions): string;
 export function formatDate(value: DateInput, options?: FormatDateOptions): string;
 export function formatDate(value: DateInput | FormatDateOptions, options?: FormatDateOptions): string {
-  if (typeof value === 'object' && value !== null && !(value instanceof Date)) {
+  if (typeof value === 'object' && value !== null && !(value instanceof Date) && !(value instanceof ZonedDateTime)) {
     return formatDate(new Date(), value);
   }
   if (value == null || value === '') {
     return '';
   }
-  const d = toDateTime(value, options);
+  const d = ZonedDateTime.parse(value, options);
   if (!d) {
     return options?.invalidText ?? 'Invalid Date';
   }
   const output = d.setZone(options?.outputTimezone ?? DEFAULT_TIMEZONE);
-  assertZone(output);
-  return options?.outputFormat ? output.toFormat(options.outputFormat) : output.toISO() as string;
+  return options?.outputFormat ? output.format(options.outputFormat, { locale: options.locale }) : output.toISO();
 }
 
 /**
@@ -229,7 +180,7 @@ export function formatDate(value: DateInput | FormatDateOptions, options?: Forma
  * @returns {boolean}
  */
 export function isValid(value: DateInput, options?: ParseDateOptions): boolean {
-  return toDateTime(value, options) != null;
+  return ZonedDateTime.parse(value, options) != null;
 }
 
 /**
@@ -300,12 +251,12 @@ export function isSameOrAfter(date1: DateInput, date2: DateInput, options?: Pars
  * @returns {boolean}
  */
 export function isPastDate(value: DateInput, options?: ParseDateOptions): boolean {
-  const target = toDateTime(value, options)?.startOf('day');
+  const target = ZonedDateTime.parse(value, options)?.startOf('day');
   if (!target) {
     return false;
   }
-  const today = DateTime.now().setZone(options?.inputTimezone ?? DEFAULT_TIMEZONE).startOf('day');
-  return target.valueOf() < today.valueOf();
+  const today = ZonedDateTime.now(target.timezone).startOf('day');
+  return target.lt(today);
 }
 
 /**
@@ -316,8 +267,8 @@ export function isPastDate(value: DateInput, options?: ParseDateOptions): boolea
  * @returns {boolean}
  */
 export function isPastDateTime(value: DateInput, options?: ParseDateOptions): boolean {
-  const target = toDateTime(value, options);
-  return target != null && target.valueOf() < Date.now();
+  const target = ZonedDateTime.parse(value, options);
+  return target != null && target.toMillis() < Date.now();
 }
 
 /**
@@ -332,14 +283,12 @@ export function isPastDateTime(value: DateInput, options?: ParseDateOptions): bo
  * @returns {number}
  */
 export function diff(date1: DateInput, date2: DateInput, unit: TimeUnit, options?: ParseDateOptions): number {
-  const d1 = toDateTime(date1, options);
-  const d2 = toDateTime(date2, options);
+  const d1 = ZonedDateTime.parse(date1, options);
+  const d2 = ZonedDateTime.parse(date2, options);
   if (!d1 || !d2) {
     return NaN;
   }
-  // 'days' → 'day' のように切り捨ての単位にする
-  const dateUnit = unit.slice(0, -1) as DateTimeUnit;
-  return d1.startOf(dateUnit).diff(d2.startOf(dateUnit), unit).get(unit);
+  return d1.diff(d2, unit);
 }
 
 /**
@@ -349,9 +298,7 @@ export function diff(date1: DateInput, date2: DateInput, unit: TimeUnit, options
  * @returns {string}
  */
 export function currentTimestamp(timezone: string = DEFAULT_TIMEZONE): string {
-  const d = DateTime.now().setZone(timezone);
-  assertZone(d);
-  return d.toFormat(TIMESTAMP_FORMAT);
+  return ZonedDateTime.now(timezone).format(TIMESTAMP_FORMAT);
 }
 
 /**
@@ -378,22 +325,6 @@ export function convertExcelDateSerialToUnixTimeSerial(excelDateSerial: number,
   return timeserial;
 }
 
-/**
- * 期間の値を別の単位に換算する
- * 月と年は固定長(1か月 = 30日、1年 = 365日)として換算する
- *
- * @example
- *   convertTimeUnit(1, 'hours', 'milliseconds');   // 3600000
- *
- * @param {number} value
- * @param {TimeUnit} inputUnit
- * @param {TimeUnit} outputUnit
- * @returns {number}
- */
-export function convertTimeUnit(value: number, inputUnit: TimeUnit, outputUnit: TimeUnit): number {
-  return LuxonDuration.fromObject({ [inputUnit]: value }).as(outputUnit);
-}
-
 /**
  * timezone が at の時点で夏時間かどうかを返す
  * at を省略した場合は現在時刻で判定する。at が解釈できない場合は false を返す
@@ -404,12 +335,8 @@ export function convertTimeUnit(value: number, inputUnit: TimeUnit, outputUnit:
  * @returns {boolean}
  */
 export function isInDST(timezone: string, at?: DateInput): boolean {
-  const d = at === undefined ? DateTime.now().setZone(timezone) : toDateTime(at)?.setZone(timezone);
-  if (d == null) {
-    return false;
-  }
-  assertZone(d);
-  return d.isInDST;
+  const d = at === undefined ? ZonedDateTime.now(timezone) : ZonedDateTime.parse(at)?.setZone(timezone);
+  return d?.isInDST ?? false;
 }
 
 /**
@@ -426,9 +353,8 @@ export function getTimezoneAbbr(timezone: string, options?: TimezoneAbbrOptions)
     return null;
   }
   if (definition.daylight) {
-    const d = DateTime.fromJSDate(options?.at ?? new Date(), { zone: timezone });
-    assertZone(d);
-    if (d.isInDST) {
+    const d = ZonedDateTime.parse(options?.at ?? new Date())?.setZone(timezone);
+    if (d?.isInDST) {
       return definition.daylight;
     }
   }

package/src/html-util.ts

@@ -57,24 +57,33 @@ const toStyleString = (value: HtmlStyleValue): string => {
     .join('; ');
 };
 
+/** diffForWebの既定の文字色 */
+const DIFF_STYLES = {
+  added: 'color: var(--dwui-color-text-diff-added, light-dark(#006400, rgb(121, 227, 121)))',
+  removed: 'color: var(--dwui-color-text-diff-removed, light-dark(#ff0000, rgb(222, 109, 109)))',
+  same: 'color: var(--dwui-color-text-diff-same, light-dark(#838383, #808080))'
+};
+
 /**
- * 値をエスケープしたspanタグを返す
+ * 値をエスケープしたタグを返す
  *
+ * @param {string} tagName
  * @param {string} value
  * @param {HtmlTagOptions} [options]
+ * @param {string} [defaultStyle] optionsのstyleより前に出力するstyle
  * @returns {string}
  */
-const toSpan = (value: string, options?: HtmlTagOptions): string => {
+const toElement = (tagName: string, value: string, options?: HtmlTagOptions, defaultStyle?: string): string => {
   let attributes = '';
   const className = options?.class == null ? '' : toClassString(options.class);
   if (className) {
     attributes += ` class="${escapeHtml(className)}"`;
   }
-  const style = options?.style == null ? '' : toStyleString(options.style);
+  const style = [defaultStyle, options?.style == null ? '' : toStyleString(options.style)].filter(Boolean).join('; ');
   if (style) {
     attributes += ` style="${escapeHtml(style)}"`;
   }
-  return `<span${attributes}>${escapeHtml(value)}</span>`;
+  return `<${tagName}${attributes}>${escapeHtml(value)}</${tagName}>`;
 };
 
 /**
@@ -127,16 +136,16 @@ export function formatJsonStringForWeb(value: any, options?: FormatJsonStringOpt
 }
 
 /**
- * 文字列の中で一致したワードをspanタグで囲んだHTML文字列を返す
+ * 文字列の中で一致したワードをmarkタグで囲んだHTML文字列を返す
  * オプションのhtmlにより、入力文字列がHTMLなのかプレーンテキストなのかを指定可能
  *
  * 例)
  * HtmlUtil.highlightWord('This is a test message', 'test', { class: 'highlight' });
- * → 'This is a <span class="highlight">test</span> message'
+ * → 'This is a <mark class="highlight">test</mark> message'
  *
  * @param {string | null | undefined} value
  * @param {string | null | undefined} word
- * @param {*} [options] spanタグに付与するclass, styleのほか、以下を指定できる
+ * @param {*} [options] markタグに付与するclass, styleのほか、以下を指定できる
  *   ├ class string | string[] | Record<string, boolean>
  *   ├ style string | Record<string, string | number>
  *   ├ caseInsensitive boolean trueを指定した場合、大文字小文字を区別しない
@@ -165,7 +174,7 @@ export function highlightWord(
   // キャプチャグループで分割すると、奇数番目の要素が一致した部分になる
   const highlight = (text: string): string => text
     .split(regex)
-    .map((part, i) => i % 2 === 0 ? toHtml(part) : toSpan(part, options))
+    .map((part, i) => i % 2 === 0 ? toHtml(part) : toElement('mark', part, options))
     .join('');
 
   if (!options?.html) {
@@ -181,7 +190,8 @@ export function highlightWord(
 
 /**
  * 文字列を1文字ずつ比較し、差分をspanタグで囲んだHTML文字列を返す
- * 追加・削除・一致の部分ごとに、spanタグに付与するclass, styleを指定できる
+ * 追加・削除・一致の部分ごとに既定の文字色を持つ。文字色はCSS変数(--dwui-color-text-diff-added / --dwui-color-text-diff-removed / --dwui-color-text-diff-same)で変更できる
+ * 追加・削除・一致の部分ごとに、spanタグに付与するclass, styleを指定できる。styleは既定の文字色より後に出力する
  * 入力文字列はプレーンなテキストであるとみなす
  * 出力される文字列は、diffで埋め込まれるHTMLタグ以外はHTMLエスケープされ、HTMLセーフな文字列となる
  *
@@ -204,11 +214,11 @@ export function diffForWeb(text1: string | null | undefined, text2: string | nul
   let html = '';
   for (const change of changes) {
     if (change.added) {
-      html += toSpan(change.value, options?.added);
+      html += toElement('span', change.value, options?.added, DIFF_STYLES.added);
     } else if (change.removed) {
-      html += toSpan(change.value, options?.removed);
+      html += toElement('span', change.value, options?.removed, DIFF_STYLES.removed);
     } else {
-      html += toSpan(change.value, options?.same);
+      html += toElement('span', change.value, options?.same, DIFF_STYLES.same);
     }
   }
   return html;

package/src/index.ts

@@ -1,4 +1,5 @@
 export * as CryptoUtil from './crypto-util';
+export { ZonedDateTime } from './zoned-date-time';
 export * as DateUtil from './date-util';
 export { Decimal } from './decimal';
 export * as FileUtil from './file-util';

package/src/json-util.ts

@@ -1,7 +1,7 @@
 /**
  * JSON.parseのreviverが第3引数で受け取る情報
  */
-interface JsonReviverContext {
+export interface JsonReviverContext {
   /** プリミティブ値のJSON上の表記 */
   source?: string;
 }
@@ -12,17 +12,20 @@ const INTEGER_LITERAL = /^-?\d+$/;
  * JSON文字列をパースする
  * Number.MIN_SAFE_INTEGER〜Number.MAX_SAFE_INTEGERの範囲外の整数はnumberに変換すると桁落ちするため、JSON上の表記のまま文字列で返す
  * そのため、同じ項目でも値の大きさによってnumberとstringが混在する
+ * reviverには、範囲外の整数を文字列にした後の値を渡す
  *
  * @param {string} source
+ * @param {(this: any, key: string, value: any, context?: JsonReviverContext) => any} [reviver]
  * @returns {T}
  */
-export function parse<T = any>(source: string): T {
-  return JSON.parse(source, (_key: string, value: any, context?: JsonReviverContext) => {
+export function parse<T = any>(source: string, reviver?: (this: any, key: string, value: any, context?: JsonReviverContext) => any): T {
+  return JSON.parse(source, function(this: any, key: string, value: any, context?: JsonReviverContext) {
     const literal = context?.source;
+    let result = value;
     if (typeof value === 'number' && !Number.isSafeInteger(value) && literal && INTEGER_LITERAL.test(literal)) {
-      return literal;
+      result = literal;
     }
-    return value;
+    return reviver ? reviver.call(this, key, result, context) : result;
   }) as T;
 }