tidsparameter

En tidsparameter är en parameter som bär tidsinformation till en funktion, ett API eller en datamodell. Den används för att ange när något ska hända, under vilken tidsperiod data ska hämtas eller hur tidsbaserad logik ska beräknas. Tidsparametrar kan vara antingen absoluta tidsindikationer, som ett specifikt klockslag, eller relativa tidsmått, som en varaktighet eller ett skuggintervall.

Format och representation av tidsparametrar varierar mellan system. Vanliga format är ISO 8601-datum och tid, RFC 3339, eller Unix-tid (ett antal sekunder eller millisekunder sedan 1970-01-01 UTC). Vissa gränssnitt använder flera fält, till exempel start och slut, medan andra använder en enda tidsstump. Det är viktigt att klargöra tidszon (oftast UTC) och precision (sekunder, millisekunder eller mikrosekunder) för att undvika missförstånd.

Användningar av tidsparametrar är vanliga i API:er och databassökningar, där de filtrerar data efter tidsintervall eller hämtar ett specifikt ögonblick. De används också i schemaläggning, simuleringar, logghantering och tidsserieanalys. I användargränssnitt kan tidsparametrar kopplas till datumväljare eller tidgränser för att styra vilka data som visas.

Vanliga överväganden inkluderar korrekt tidszonering, hantering av tidsgränser (inklusive eller exklusive), precision och konvertering mellan format. God praxis är tydlig dokumentation av vilket format som krävs och hur falska eller saknade värden hanteras.

Se även: tidsstämpel, ISO 8601, Unix-tid, tidszon.