Temps d'època a APIs i logs explicat: com llegir-lo i convertir-lo correctament
El temps d'època és un d'aquells formats tècnics que apareixen a tot arreu i, alhora, resulten sorprenentment poc amigables per a les persones.
Veus un enter llarg en una resposta d'API, una entrada de log o un registre de base de dades i de seguida saps que representa una data i una hora — però no una data i una hora que ningú pugui llegir sense convertir-la abans.
Per això la gent busca què és el temps d'època, convertidor de temps d'època i com llegir un Unix timestamp als logs. El número és senzill per als sistemes, però no és intuïtiu per a qui intenta depurar, auditar o comparar esdeveniments.
Què vol dir realment el temps d'època
El temps d'època sol referir-se al nombre de segons que han transcorregut des de:
January 1, 1970, 00:00:00 UTC
Aquest punt de referència s'anomena habitualment època Unix.
Així que si veus un número com:
1711929600
representa un moment concret comptat des d'aquest punt d'inici fix.
Per això el temps d'època també s'anomena sovint Unix timestamp.
Si vols convertir un timestamp a una data llegible immediatament, el Unix Timestamp Converter és la manera més senzilla de fer-ho.
Per què les APIs i els logs fan servir temps d'època
Els sistemes fan servir temps d'època perquè és:
- compacte
- ordenable
- no ambigu
- fàcil de comparar matemàticament
Una cadena com:
04/03/2026 10:15 PM
es pot interpretar de manera diferent segons la configuració regional, el format i el fus horari.
Un Unix timestamp evita aquesta ambigüitat. Les màquines el poden emmagatzemar, comparar i transmetre entre sistemes sense discutir com s'ha de llegir.
Per això el veus a:
- payloads d'API
- logs d'aplicació
- esdeveniments d'analítica
- lògica de caducitat de la memòria cau
- camps de base de dades
Segons vs mil·lisegons: el problema més habitual
Aquí és on molta gent s'hi encalla.
Alguns sistemes emmagatzemen el temps d'època en:
- segons
D'altres fan servir:
- mil·lisegons
Exemples:
- Segons:
1711929600 - Mil·lisegons:
1711929600000
Si confons mil·lisegons amb segons, la data convertida serà completament errònia. El mateix passa a l'inrevés.
Aquest és un dels errors de depuració més comuns quan es treballa entre JavaScript, serveis back-end i bases de dades.
Per què l'UTC és important
El temps d'època es basa en l'UTC, no en el teu fus horari local.
Això vol dir que el timestamp en si representa un moment universal. La visualització local depèn d'on i com el converteixis.
Per tant, el mateix timestamp pot aparèixer com:
- una data de calendari en una regió
- i una hora local diferent en un altre lloc
El timestamp no canvia. Només canvia la interpretació en format llegible.
Per què desenvolupadors i analistes necessiten la conversió a format humà
Les màquines estan perfectament còmodes amb el temps d'època. Les persones no.
Si intentes respondre preguntes com:
- Quan va passar aquest esdeveniment?
- Quina petició va arribar primer?
- Quant de temps va passar entre aquests dos esdeveniments?
- Això va caducar abans o després de mitjanit?
normalment necessites traduir el timestamp a una data i hora llegibles.
Aquí és on la depuració manual es torna molt més fàcil un cop converteixes el valor brut.
Com es relaciona el temps d'època amb els càlculs de durada
Un cop els timestamps es converteixen o es comparen numèricament, la durada és la següent pregunta.
Per exemple:
- Quants dies van passar entre dos esdeveniments d'usuari?
- Quant temps entre la creació del compte i l'última activitat?
- Quants dies entre dos registres del sistema?
Per això treballar amb Unix timestamps sovint se solapa amb la lògica d'intervals de dates. El Days Between Dates Calculator és útil quan el problema canvia de “quin moment és aquest?” a “quant de temps ha passat entre aquests moments?”
Errors habituals
1. Confondre segons amb mil·lisegons
És, de llarg, el problema més freqüent.
2. Oblidar que el timestamp és en UTC
Sovint la gent pensa que el valor ha canviat quan en realitat només ha canviat el fus horari de visualització.
3. Comparar dates en format humà en lloc de timestamps crus
En entorns de sistemes, el timestamp sol ser el format de comparació més segur.
4. Tractar els timestamps com si fossin llegibles sense conversió
Pots reconèixer el patró, però un enter llarg encara necessita traducció abans que sigui útil per a la majoria de persones.
Un exemple pràctic
Suposa que dos logs mostren:
17119296001712016000
Fins i tot abans de convertir-los a dates llegibles, pots restar-los i veure la diferència en segons. Un cop convertits, el resultat adquireix sentit com a temps real transcorregut al calendari.
Per això els timestamps d'època són tan útils en feina de sistemes: són fàcils de comparar per a les màquines i fàcils d'entendre per a les persones un cop es converteixen correctament.
Resum final
Si vols entendre el temps d'època a APIs i logs, els punts clau són senzills: representa segons des de l'1 de gener de 1970 UTC, s'usa perquè és inequívoc per als sistemes, i la confusió més habitual és el format segons vs mil·lisegons.
Fes servir el Unix Timestamp Converter quan necessitis convertir el temps d'època cru a una data llegible, i el Days Between Dates Calculator quan la següent pregunta sigui quant de temps ha passat entre dos esdeveniments.
