time t

Descripcion

time_t es un tipo unsigned long de 4 byte (32 bits) usado para almacenar los segundos transcurridos desde el 1-ENE-1970 o también llamada Unix Time Stamp.

Sintaxis

time_t variable [= valor];

Parámetros

variable

Nombre de la variable que definiras.

valor

Numero del tipo TimeStamp de UNIX. Numero tipo unsigned long.

Funciones

Metodos disponibles para time_t

Metodo	Descripcion	Ejemplo
now()	Almacena la hora actual en tiempo UNIX	time_t t = now();
hour()	Muestra las horas (0~23)	hour(t);
minute()	Muestra los minutos (0~59)	minute(t);
second()	Muestra los segundos (0~59)	second(t);
millis()	Muestra los milisegundos (0~999)	millis();
day()	Muetsra el dia (1~31)	day(t);
weekday()	Muestra dia de la semana (1=domingo) (1~7)	weekday(t);
month()	Muestra el mes (1~12)	mont(t);
year()	Muestra el año	year(t);
hourFormat12()	Formatea a 12 horas
isAM()	Devuelve verdadero por la mañana	isAM(t)
isPM()	Devuelve verdadero por la tarde	isPM(t);
monthStr()	Nombre del mes	monthStr(t);
monthShortStr()	Nombre del mes corto	monthShortStr(t);
dayStr()	Nombre del dia	dayStr(t);
dayShortStr()	Nombre del dia corto	dayShortStr(t);
setTime()	Establece fecha-hora. Puede ser en segundos o hr,min,sec,dia,mes,año.	setTime(0,0,0,14,7,2018);
adjustTime()	Ajusta la fecha-hora del sistema agregando un valor	adjustTime(3600);
makeTime()	Convierte variable tipo tmElement_t en variable tipo time_t	makeTime(tm);
breakTime()	Convierte variable tipo time_t en variable tipo tmElement_t	makeTime(tm);
timeStatus()	Indica si el tiempo se sincronizado recientemente. Devuelve: timeNotSet/timeNeedSync/timeSet
setSyncProvider()	Establecer proveedor de hora externa
setSyncInterval()	Establecer el número de segundos entre re-sincronizaciones

Comentarios

• La libreria TimeLib.h agrega la funcionalidad de reloj a Arduino sin hardware externo. Permite que un boceto obtenga la hora y la fecha como: segundo, minuto, hora, día, mes y año.
• También proporciona tiempo time_t estándar, por lo que los tiempos transcurridos se pueden calcular fácilmente y los valores de tiempo se pueden compartir en diferentes plataformas.

Advertencias

• Tenga en cuenta que se requiere un parámetro para estas funciones de cadena. El argumento NO es la marca de tiempo, por ejemplo, time_t, pero debe ser algo así como month(t). Entonces monthStr(month(t)) o dayStr(day(t)) funcionará.

Ejemplo 1

En este ejemplo incluimos la fecha hora 2018-7-14 10:0:0 y mostramos su avance cada 1350 milisegundos.

#include <TimeLib.h>
void setup(){
   Serial.begin(9600);
   setTime(10,0,0,14,7,2018);  //h,min,seg,dia,mes,año
}
void loop(){
   time_t t=now();
   Serial.print(hour(t));
   Serial.print(":");
   Serial.print(minute(t));
   Serial.print(":");
   Serial.println(second(t));
   delay(1350);
}

Ejemplo 2

En este ejemplo podemos enviar la fecha-hora por consola serie. Para convertir Unix Time te recomiendo usar esto. Ejemplo: T1552204800 = 2019-MAR-10 8:00:00

#include <TimeLib.h>
#define TIME_HEADER  "T"   //Encabezado de mensaje de sincronizacion

void setup()  {
   Serial.begin(9600);
   while (!Serial);        //Solo se requiere para Leonardo
   pinMode(13, OUTPUT);
   Serial.println("Esperando mensaje de sincronizacion");
}

void loop(){    
   if (Serial.available()) {
      sincro();
   }
   if (timeStatus() == timeSet) {
      pantalla();                  //Muestra fecha hora
      digitalWrite(13, HIGH);      //Sincronizado
   }else{
      digitalWrite(13, LOW);       //Requiere sincronizar
   }
   delay(1000);
}

void sincro() {
   if (Serial.find(TIME_HEADER)) {
      unsigned long pctime = Serial.parseInt();
      if (pctime >= 1357041600) {       //Verifica valides de fecha-hora (mayor a 1-ENE-2013)
         setTime(pctime);               //Sincroniza reloj Arduino con fecha-hora recivida por puerto serie
      }
   }
}

void pantalla(){
   Serial.print(year()); 
   Serial.print('-');
   Serial.print(month());
   Serial.print('-');
   Serial.print(day());
   Serial.print(' ');
   Serial.print(hour());
   printDigito(minute());
   printDigito(second());
   Serial.println();
}

void printDigito(int dig){
   Serial.print(':');
   if (dig < 10){
      Serial.print('0');
   }
   Serial.print(dig);
}

Ejemplo 3

Con este ejemplo Arduino espera que se envíe desde el monitor un tiempo UNIX del formato T1531526400 (2018-7-14 0:0:0).

#include <TimeLib.h>

void setup(){
   Serial.begin(9600);
   pinMode(13, OUTPUT);
   Serial.println("Esperando tiempo UNIX por puerto serie");
}

void loop(){    
   if (Serial.available()) {
      sincroniza();
   }
   if (timeStatus()!= timeNotSet) {
      reloj();  
   }
   if (timeStatus() == timeSet) {
      digitalWrite(13, HIGH); //Sincronizado
   }else{
      digitalWrite(13, LOW);  //Falta sincronizar
   }
   delay(1000);
}

void reloj(){
   Serial.print(year()); 
   Serial.print("-");
   if (month()<10){
      Serial.print('0');
   }
   Serial.print(month());
   Serial.print("-");
   if (day()<10){
      Serial.print('0');
   }
   Serial.print(day());
   Serial.print(" ");
   if (hour()<10){
      Serial.print('0');
   }
   Serial.print(hour());
   Serial.print(":");
   if (minute() < 10){
      Serial.print('0');
   }
   Serial.print(minute());
   Serial.print(":");
   if (second() < 10){
      Serial.print('0');
   }
   Serial.println(second());
}

void sincroniza() {
   const unsigned long DEFAULT_TIME = 1514764800; //1-ENE-2018

   if (Serial.find("T")) {
      unsigned long pc = Serial.parseInt();
      //Controla valides mayor a 1-ENE-2018
      if (pc >= DEFAULT_TIME) { 
         setTime(pc);      //Ajusta la fecha-hora
      }
   }
}

Vea también

• Fecha y hora
• tmElements_t - TimeLib.h
• setTime() - TimeLib.h
• adjustTime() - TimeLib.h
• timeStatus() - TimeLib.h
• makeTime() - TimeLib.h
• breakTime() - TimeLib.h
• DateTime - RTClib.h

Referencias

• Guia de referencia Arduino
• TimeLib.h - Paul Stoffregen
• RTClib.h - Adafruit