KSDate.h 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455
  1. //
  2. // KSDate.h
  3. //
  4. // Copyright 2016 Karl Stenerud.
  5. //
  6. // Permission is hereby granted, free of charge, to any person obtaining a copy
  7. // of this software and associated documentation files (the "Software"), to deal
  8. // in the Software without restriction, including without limitation the rights
  9. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10. // copies of the Software, and to permit persons to whom the Software is
  11. // furnished to do so, subject to the following conditions:
  12. //
  13. // The above copyright notice and this permission notice shall remain in place
  14. // in this source code.
  15. //
  16. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22. // THE SOFTWARE.
  23. //
  24. #ifndef KSDate_h
  25. #define KSDate_h
  26. #ifdef __cplusplus
  27. extern "C" {
  28. #endif
  29. #include <sys/types.h>
  30. /** Convert a UNIX timestamp to an RFC3339 string representation.
  31. *
  32. * @param timestamp The date to convert.
  33. *
  34. * @param buffer21Chars A buffer of at least 21 chars to hold the RFC3339 date string.
  35. */
  36. void ksdate_utcStringFromTimestamp(time_t timestamp, char* buffer21Chars);
  37. /** Convert microseconds returned from `gettimeofday` to an RFC3339 string representation.
  38. *
  39. * @param microseconds The microseconds to convert.
  40. *
  41. * @param buffer28Chars A buffer of at least 28 chars to hold the RFC3339 date string with milliseconds precision.
  42. */
  43. void ksdate_utcStringFromMicroseconds(int64_t microseconds, char* buffer28Chars);
  44. #ifdef __cplusplus
  45. }
  46. #endif
  47. #endif /* KSDate_h */