@rr0/time/src/level2/date/Level2Date.mjs

EDTF parsing

import { Level2DateParser } from "./Level2DateParser.mjs"
import { Level1Date } from "../../level1/date/Level1Date.mjs"
import { level2Factory } from "../Level2Factory.mjs"
/** @import { EDTFParser } from "../../EDTFParser.mjs" */
/** @import { Level2Year } from "../year/Level2Year.mjs" */
/** @import { Level2Month } from "../month/Level2Month.mjs" */
/** @import { Level2Day } from "../day/Level2Day.mjs" */
/** @import { Level2Hour } from "../hour/Level2Hour.mjs" */
/** @import { Level2Minute } from "../minute/Level2Minute.mjs" */
/** @import { Level2Second } from "../second/Level2Second.mjs" */
/** @import { Level2Timeshift } from "../timeshift/Level2Timeshift.mjs" */
/** @import { Level2Factory } from "../Level2Factory.mjs" */

/**
 * @typedef {Object} Level2DateSpec
 * @property {Level2Year|number} year
 * @property {Level2Month|number} [month]
 * @property {Level2Day|number} [day]
 * @property {Level2Hour|number} [hour]
 * @property {Level2Minute|number} [minute]
 * @property {Level2Second|number} [second]
 * @property {Level2Timeshift|number} [timeshift]
 */

/**
 * A level 2 EDTF Date.
 *
 * @template {Level2Year} [Y=Level2Year]
 * @template {Level2Month} [MM=Level2Month]
 * @template {Level2Day} [D=Level2Day]
 * @template {Level2Hour} [H=Level2Hour]
 * @template {Level2Minute} [M=Level2Minute]
 * @template {Level2Second} [S=Level2Second]
 * @template {Level2Timeshift} [Z=Level2Timeshift]
 * @extends {Level1Date<Level2Year, Level2Month, Level2Day, Level2Hour, Level2Minute, Level2Second, Level2Timeshift>}
 */
export class Level2Date extends Level1Date {
  /**
   * @param {Level2DateSpec|undefined} [spec]
   */
  constructor(spec) {
    super(spec)
  }

  /**
   * @return {Level2Year|undefined}
   */
  get year() {
    return super.year
  }

  /**
   * @param {Level2Year|undefined} value
   */
  set year(value) {
    super.year = value
  }

  /**
   * @return {Level2Month|undefined}
   */
  get month() {
    return super.month
  }

  /**
   * @param {Level2Month|undefined} value
   */
  set month(value) {
    super.month = value
  }

  /**
   * @type {Level2Factory}
   */
  get factory() {
    return level2Factory
  }

  /**
   * @param {Date} date
   * @return {Level2Date}
   */
  static fromDate(date) {
    return new Level2Date({
      year: date.getFullYear(),
      month: date.getMonth() + 1,
      day: date.getDate(),
      hour: date.getHours(),
      minute: date.getSeconds(),
      second: date.getSeconds(),
      timeshift: date.getTimezoneOffset()
    })
  }

  /**
   * @param {string} str An EDTF level 0-2 string
   * @param {EDTFParser} parser
   * @return {Level2Date<Level2Year,Level2Month>}
   */
  static fromString(str, parser = new Level2DateParser()) {
    const spec = parser.parse(str)
    return new Level2Date(spec)
  }

  static newInstance() {
    const utcNow = new Date().toISOString()
    const millisPos = utcNow.indexOf(".")
    const edtfNow = utcNow.substring(0, millisPos) + utcNow.substring(millisPos + 4)
    return Level2Date.fromString(edtfNow)
  }

  clone() {
    return new Level2Date(this.toSpec())
  }
}