Class DateTimeValue

packages/graph/src/TemporalTypes.ts:703–1032

 * - timezone: The timezone name (if provided)
 */
export class DateTimeValue implements TemporalValue {
  public readonly temporalType = "datetime";

  #year: number;
  #month: number;
  #day: number;
  #hour: number;
  #minute: number;
  #second: number;
  #nanosecond: number;
  #offsetSeconds: number;
  #timezone: string | null;

  public constructor(
    year: number,
    month: number,
    day: number,
    hour: number = 0,
    minute: number = 0,
    second: number = 0,
    nanosecond: number = 0,
    offsetSeconds: number = 0,
    timezone: string | null = null,
  ) {
    this.#year = year;
    this.#month = month;
    this.#day = day;
    this.#hour = hour;
    this.#minute = minute;
    this.#second = second;
    this.#nanosecond = nanosecond;
    this.#offsetSeconds = offsetSeconds;
    this.#timezone = timezone;
  }

  /**
   * Create a DateTimeValue from an ISO datetime string with timezone.
   * Format: YYYY-MM-DDTHH:MM:SS.nnnnnnnnn+HH:MM or YYYY-MM-DDTHH:MM:SS.nnnnnnnnn[TZ]
   */
  public static fromString(iso: string): DateTimeValue | null {
    // Match datetime with timezone offset or named timezone
    const match = iso.match(
      /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?(Z|([+-])(\d{2}):(\d{2}))?(?:\[([^\]]+)\])?$/,
    );
    if (!match || !match[1] || !match[2] || !match[3] || !match[4] || !match[5] || !match[6])
      return null;

    const year = parseInt(match[1], 10);
    const month = parseInt(match[2], 10);
    const day = parseInt(match[3], 10);
    const hour = parseInt(match[4], 10);
    const minute = parseInt(match[5], 10);
    const second = parseInt(match[6], 10);

    let nanosecond = 0;
    if (match[7]) {
      const frac = match[7].padEnd(9, "0");
      nanosecond = parseInt(frac, 10);