EmbeddedPkg/Include/Library/TimeBaseLib.h

   1 /** @file
   2 *
   3 *  Copyright (c) 2016, Hisilicon Limited. All rights reserved.
   4 *  Copyright (c) 2016-2019, Linaro Limited. All rights reserved.
   5 *
   6 *  SPDX-License-Identifier: BSD-2-Clause-Patent
   7 *
   8 **/
   9
  10 #ifndef _TIME_BASE_LIB_H_
  11 #define _TIME_BASE_LIB_H_
  12
  13 #include <Uefi/UefiBaseType.h>
  14
  15 //
  16 // Convenience macros to obtain a build date
  17 //
  18 // These macros should work for any compiler that follows ISO/IEC 9899,
  19 // in which case __DATE__ is defined as a "Mmm dd yyyy" 11 chars string,
  20 // but add an explicit filter for compilers that have been validated.
  21 //
  22 #if (defined(__GNUC__) || defined(_MSC_VER) || defined(__clang__))
  23 #define TIME_BUILD_YEAR  (__DATE__[7] == '?' ? 1900 \
  24           : (((__DATE__[7] - '0') * 1000 )          \
  25           + (__DATE__[8] - '0') * 100               \
  26           + (__DATE__[9] - '0') * 10                \
  27           + __DATE__[10] - '0'))
  28 #define TIME_BUILD_MONTH ( __DATE__ [2] == '?' ? 1  \
  29           : __DATE__ [2] == 'n' ? (                 \
  30             __DATE__ [1] == 'a' ? 1 : 6)            \
  31           : __DATE__ [2] == 'b' ? 2                 \
  32           : __DATE__ [2] == 'r' ? (                 \
  33             __DATE__ [0] == 'M' ? 3 : 4)            \
  34           : __DATE__ [2] == 'y' ? 5                 \
  35           : __DATE__ [2] == 'l' ? 7                 \
  36           : __DATE__ [2] == 'g' ? 8                 \
  37           : __DATE__ [2] == 'p' ? 9                 \
  38           : __DATE__ [2] == 't' ? 10                \
  39           : __DATE__ [2] == 'v' ? 11                \
  40           : 12)
  41 #define TIME_BUILD_DAY ( __DATE__[4] == '?' ? 1     \
  42           : ((__DATE__[4] == ' ' ? 0 :              \
  43             ((__DATE__[4] - '0') * 10))             \
  44           + __DATE__[5] - '0'))
  45 #endif
  46
  47 // Define EPOCH (1970-JANUARY-01) in the Julian Date representation
  48 #define EPOCH_JULIAN_DATE                               2440588
  49
  50 // Seconds per unit
  51 #define SEC_PER_MIN                                     ((UINTN)    60)
  52 #define SEC_PER_HOUR                                    ((UINTN)  3600)
  53 #define SEC_PER_DAY                                     ((UINTN) 86400)
  54
  55 BOOLEAN
  56 EFIAPI
  57 IsLeapYear (
  58   IN  EFI_TIME  *Time
  59   );
  60
  61 BOOLEAN
  62 EFIAPI
  63 IsDayValid (
  64   IN  EFI_TIME  *Time
  65   );
  66
  67 BOOLEAN
  68 EFIAPI
  69 IsTimeValid (
  70   IN  EFI_TIME  *Time
  71   );
  72
  73 /**
  74   Converts Epoch seconds (elapsed since 1970 JANUARY 01, 00:00:00 UTC) to EFI_TIME
  75  **/
  76 VOID
  77 EFIAPI
  78 EpochToEfiTime (
  79   IN  UINTN     EpochSeconds,
  80   OUT EFI_TIME  *Time
  81   );
  82
  83 /**
  84   Converts EFI_TIME to Epoch seconds (elapsed since 1970 JANUARY 01, 00:00:00 UTC)
  85  **/
  86 UINT32
  87 EFIAPI
  88 EfiTimeToEpoch (
  89   IN  EFI_TIME  *Time
  90   );
  91
  92 /**
  93   returns Day of the week [0-6] 0=Sunday
  94  **/
  95 UINTN
  96 EfiTimeToWday (
  97   IN  EFI_TIME  *Time
  98   );
  99
 100 #endif