chronia
    Preparing search index...

    Function setSeconds

    • Set the seconds of the given date.

      This function validates arguments before processing and returns a new Date instance with the specified seconds set. Fractional seconds are truncated toward zero.

      Parameters

      • date: number | Date

        The base date as a Date object or timestamp (number)

      • seconds: number

        The seconds to set (0-59 for normal range, other values will roll over)

      Returns Date

      A new Date object with the seconds set, or Invalid Date if any input is invalid

      // Set seconds to 30
      const result = setSeconds(new Date(2025, 0, 15, 12, 30, 45), 30);
      // Returns: 2025-01-15 12:30:30

      // Set seconds to 0 (start of minute)
      const result2 = setSeconds(new Date(2025, 0, 15, 12, 30, 45), 0);
      // Returns: 2025-01-15 12:30:00

      // Seconds rollover to next minute
      const result3 = setSeconds(new Date(2025, 0, 15, 12, 30, 45), 60);
      // Returns: 2025-01-15 12:31:00

      // Fractional seconds are truncated
      const result4 = setSeconds(new Date(2025, 0, 15, 12, 30, 45), 30.9);
      // Returns: 2025-01-15 12:30:30

      // Invalid date returns Invalid Date
      const result5 = setSeconds(new Date("invalid"), 30);
      // Returns: Invalid Date
      • Validates arguments before conversion (consistent with library patterns)
      • Accepts both Date objects and numeric timestamps
      • Fractions are truncated using Math.trunc (30.9 → 30, -30.9 → -30)
      • Returns Invalid Date for: Invalid Date, NaN, Infinity, -Infinity
      • Preserves year, month, day, hours, minutes, and milliseconds components
      • Seconds outside 0-59 range cause rollover to adjacent minutes (60 → next minute, -1 → previous minute)
      • Always returns a new Date instance (does not mutate input)

    Settings

    Member Visibility