Class TimeValue

packages/graph/src/TemporalTypes.ts:321–484

 * - offsetMinutes: The timezone offset in minutes
 */
export class TimeValue implements TemporalValue {
  public readonly temporalType = "time";

  #hour: number;
  #minute: number;
  #second: number;
  #nanosecond: number;
  #offsetSeconds: number;

  public constructor(
    hour: number,
    minute: number,
    second: number,
    nanosecond: number = 0,
    offsetSeconds: number = 0,
  ) {
    this.#hour = hour;
    this.#minute = minute;
    this.#second = second;
    this.#nanosecond = nanosecond;
    this.#offsetSeconds = offsetSeconds;
  }

  /**
   * Create a TimeValue from an ISO time string with timezone offset.
   * Format: HH:MM:SS.nnnnnnnnn+HH:MM or HH:MM:SS.nnnnnnnnnZ
   */
  public static fromString(iso: string): TimeValue | null {
    // Match time with timezone: HH:MM:SS.frac+HH:MM or Z
    const match = iso.match(/^(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?(Z|([+-])(\d{2}):(\d{2}))$/);
    if (!match || !match[1] || !match[2] || !match[3]) return null;

    const hour = parseInt(match[1], 10);
    const minute = parseInt(match[2], 10);
    const second = parseInt(match[3], 10);

    // Parse fractional seconds as nanoseconds
    let nanosecond = 0;
    if (match[4]) {
      const frac = match[4].padEnd(9, "0");
      nanosecond = parseInt(frac, 10);
    }

    // Parse timezone offset
    let offsetSeconds = 0;
    if (match[5] !== "Z" && match[6] && match[7] && match[8]) {
      const sign = match[6] === "+" ? 1 : -1;
      const offsetHours = parseInt(match[7], 10);
      const offsetMins = parseInt(match[8], 10);
      offsetSeconds = sign * (offsetHours * 3600 + offsetMins * 60);
    }

    return new TimeValue(hour, minute, second, nanosecond, offsetSeconds);
  }

  /**
   * Create a TimeValue from a map of components.
   */