Skip to main content

SecondOf

Function SecondOf( const AValue : TDateTime) : Word

Example​

procedure ScriptEvent(var Value: variant);
var
  InputValue: TDateTime;
begin
  InputValue := EncodeDateTime(2026, 7, 16, 9, 42, 56, 250);
  Value := SecondOf(InputValue); // 56
end;

Usage​

SecondOf returns the encoded second-within-minute component from 0 through 59.

Parameters

NameTypeDescription
AValueTDateTime, constEncoded date/time whose second field is required.

Behaviour

  • Milliseconds do not round or change the result.
  • Date fields are ignored.
  • Valid pre-epoch values are handled by Velox's sign-aware time decoder.
  • No timezone or locale conversion occurs.

Errors

Velox adds no validation or exception translation. Decode errors propagate.

Usage notes

Use SecondOfTheMinute for the exact alias, or SecondOfTheDay for a zero-based day index.

Additional Technical Info​

SecondOf extracts the encoded second-within-minute field from a TDateTime.

The example is fictional, deterministic and source-reviewed. It was not executed by the documentation workflow.

Implementation

The DateUtils import calls Delphi 37.0 System.DateUtils.SecondOf. The routine delegates to DecodeTime, discards the decoded hour, minute and millisecond, and returns the second field.

Edge cases and quirks

  • This is a component, not a count of seconds since midnight or an elapsed duration.
  • Leap-second value 60 is not representable by Delphi's encoder.
  • Invalid or non-finite raw input can raise during decoding rather than returning a sentinel.
  • Free Pascal exposes the same component range; installed Delphi remains authoritative for Velox.

Side effects

None.

Performance and concurrency

Constant-time field decoding with no I/O or shared mutable state.

Related entries

External references

Created 2026-07-15