Julien Castello / FrenchTime

Calcule le décalage horaire en France (+1 en été, +2 en hiver) à partir d'une heure UTC et d'une date.

Fork of FrenchTime by Julien Castello

FrenchTime.h.orig@6:803a1cf4eb73, 2016-11-23 (annotated)

Committer:
Marcus_2B
Date:
Wed Nov 23 14:46:23 2016 +0000
Revision:
6:803a1cf4eb73
Publish 1

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Marcus_2B 6:803a1cf4eb73 1 #ifndef MBED_FRENCH_TIME_H
Marcus_2B 6:803a1cf4eb73 2 #define MBED_FRENCH_TIME_H
Marcus_2B 6:803a1cf4eb73 3
Marcus_2B 6:803a1cf4eb73 4 #include "mbed.h"
Marcus_2B 6:803a1cf4eb73 5
Marcus_2B 6:803a1cf4eb73 6 #define UTC_TIME_OFFSET 1
Marcus_2B 6:803a1cf4eb73 7 #define DAYS_IN_MARS 31
Marcus_2B 6:803a1cf4eb73 8
Marcus_2B 6:803a1cf4eb73 9
Marcus_2B 6:803a1cf4eb73 10
Marcus_2B 6:803a1cf4eb73 11 /**
Marcus_2B 6:803a1cf4eb73 12 * Classe qui permet de calculer l'heure locale en France à partir de l'heure UTC provenant d'un GPS par exemple.
Marcus_2B 6:803a1cf4eb73 13 * Le passage à l'heure d'été est réalisé le dernier dimanche de mars à 00:00
Marcus_2B 6:803a1cf4eb73 14 * Le passage à l'heure d'hiver est réalisé le dernier dimanche d'octobre à 00:00
Marcus_2B 6:803a1cf4eb73 15 */
Marcus_2B 6:803a1cf4eb73 16 class FrenchTime
Marcus_2B 6:803a1cf4eb73 17 {
Marcus_2B 6:803a1cf4eb73 18
Marcus_2B 6:803a1cf4eb73 19 public:
Marcus_2B 6:803a1cf4eb73 20
Marcus_2B 6:803a1cf4eb73 21 /** Mois de l'année */
Marcus_2B 6:803a1cf4eb73 22 enum month {JANVIER = 1 /**<Le mois de Janvier = 1*/, FEVRIER /**< 2 */, MARS /**< 3 */, AVRIL /**< 4 */, MAI /**< 5 */, JUIN /**< 6 */, JUILLET /**< 7 */, AOUT /**< 8 */, SEPTEMBRE /**< 9 */, OCTOBRE /**< 10 */, NOVEMBRE /**< 11 */, DECEMBRE /**< 12 */ };
Marcus_2B 6:803a1cf4eb73 23
Marcus_2B 6:803a1cf4eb73 24 /** Jours de la semaine */
Marcus_2B 6:803a1cf4eb73 25 enum dayOfWeek {DIM = 0 /**<Dimanche = 0 */, LUN /**< 1 */, MAR /**< 2 */, MER /**< 3 */, JEU /**< 4 */, VEN /**< .5 */, SAM /**<Samedi = 6 */ };
Marcus_2B 6:803a1cf4eb73 26
Marcus_2B 6:803a1cf4eb73 27
Marcus_2B 6:803a1cf4eb73 28 /**
Marcus_2B 6:803a1cf4eb73 29 * Methode qui revoie le décalage horaire de l'heure francaise par rapport à l'heure UTC
Marcus_2B 6:803a1cf4eb73 30 * @param day date du jour
Marcus_2B 6:803a1cf4eb73 31 * @param month mois
Marcus_2B 6:803a1cf4eb73 32 * @param year année
Marcus_2B 6:803a1cf4eb73 33 * @returns
Marcus_2B 6:803a1cf4eb73 34 * uint8_t 1 (hiver)
Marcus_2B 6:803a1cf4eb73 35 * uint8_t 2 (été)
Marcus_2B 6:803a1cf4eb73 36 *
Marcus_2B 6:803a1cf4eb73 37 * @code
Marcus_2B 6:803a1cf4eb73 38 * int DecalageHoraire = FrenchTime::frenchTimeOffset(29,10,2016); //return 1
Marcus_2B 6:803a1cf4eb73 39 * int DecalageHoraire = FrenchTime::frenchTimeOffset(30,10,2016); //return 2
Marcus_2B 6:803a1cf4eb73 40 * @endcode
Marcus_2B 6:803a1cf4eb73 41 */
Marcus_2B 6:803a1cf4eb73 42 static uint8_t frenchTimeOffset(uint8_t day, uint8_t month, int year);
Marcus_2B 6:803a1cf4eb73 43
Marcus_2B 6:803a1cf4eb73 44
Marcus_2B 6:803a1cf4eb73 45 /**
Marcus_2B 6:803a1cf4eb73 46 * Methode qui renvoie la date du dernier dimanche d'un mois
Marcus_2B 6:803a1cf4eb73 47 * @param month mois
Marcus_2B 6:803a1cf4eb73 48 * @param year année
Marcus_2B 6:803a1cf4eb73 49 * @return uin8_t jour du mois de 1 à 31
Marcus_2B 6:803a1cf4eb73 50 *
Marcus_2B 6:803a1cf4eb73 51 * @code
Marcus_2B 6:803a1cf4eb73 52 * int dateDuDernierDimancheDuMois = FrenchTime::lastSundayOfMonth(5,2016); //return 29
Marcus_2B 6:803a1cf4eb73 53 * @endcode
Marcus_2B 6:803a1cf4eb73 54 */
Marcus_2B 6:803a1cf4eb73 55 static uint8_t lastSundayOfMonth(uint8_t month, int year);
Marcus_2B 6:803a1cf4eb73 56
Marcus_2B 6:803a1cf4eb73 57
Marcus_2B 6:803a1cf4eb73 58 /**
Marcus_2B 6:803a1cf4eb73 59 * Methode qui renvoie le jour de la semaine correspondant à une date
Marcus_2B 6:803a1cf4eb73 60 * @param day date du jour
Marcus_2B 6:803a1cf4eb73 61 * @param month mois
Marcus_2B 6:803a1cf4eb73 62 * @param year année
Marcus_2B 6:803a1cf4eb73 63 * @return uin8_t jour de la semaine de 0(dimanche) à 6(samedi)
Marcus_2B 6:803a1cf4eb73 64 *
Marcus_2B 6:803a1cf4eb73 65 * @code
Marcus_2B 6:803a1cf4eb73 66 * int jour = FrenchTime::dayOfWeek(22,6,2016); //return 3
Marcus_2B 6:803a1cf4eb73 67 * @endcode
Marcus_2B 6:803a1cf4eb73 68 */
Marcus_2B 6:803a1cf4eb73 69 static uint8_t dayOfWeek(uint8_t day, uint8_t month, int year);
Marcus_2B 6:803a1cf4eb73 70 };
Marcus_2B 6:803a1cf4eb73 71
Marcus_2B 6:803a1cf4eb73 72 #endif