1// Protocol Buffers - Google's data interchange format
2// Copyright 2008 Google Inc. All rights reserved.
3// https://developers.google.com/protocol-buffers/
4//
5// Redistribution and use in source and binary forms, with or without
6// modification, are permitted provided that the following conditions are
7// met:
8//
9// * Redistributions of source code must retain the above copyright
10// notice, this list of conditions and the following disclaimer.
11// * Redistributions in binary form must reproduce the above
12// copyright notice, this list of conditions and the following disclaimer
13// in the documentation and/or other materials provided with the
14// distribution.
15// * Neither the name of Google Inc. nor the names of its
16// contributors may be used to endorse or promote products derived from
17// this software without specific prior written permission.
18//
19// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30#ifndef GOOGLE_PROTOBUF_STUBS_TIME_H_
31#define GOOGLE_PROTOBUF_STUBS_TIME_H_
32
33#include <cstdint>
34
35#include <google/protobuf/stubs/common.h>
36
37#include <google/protobuf/port_def.inc>
38
39namespace google {
40namespace protobuf {
41namespace internal {
42
43struct DateTime {
44 int year;
45 int month;
46 int day;
47 int hour;
48 int minute;
49 int second;
50};
51
52// Converts a timestamp (seconds elapsed since 1970-01-01T00:00:00, could be
53// negative to represent time before 1970-01-01) to DateTime. Returns false
54// if the timestamp is not in the range between 0001-01-01T00:00:00 and
55// 9999-12-31T23:59:59.
56bool PROTOBUF_EXPORT SecondsToDateTime(int64_t seconds, DateTime* time);
57// Converts DateTime to a timestamp (seconds since 1970-01-01T00:00:00).
58// Returns false if the DateTime is not valid or is not in the valid range.
59bool PROTOBUF_EXPORT DateTimeToSeconds(const DateTime& time, int64_t* seconds);
60
61void PROTOBUF_EXPORT GetCurrentTime(int64_t* seconds, int32_t* nanos);
62
63// Formats a time string in RFC3339 format.
64//
65// For example, "2015-05-20T13:29:35.120Z". For nanos, 0, 3, 6 or 9 fractional
66// digits will be used depending on how many are required to represent the exact
67// value.
68//
69// Note that "nanos" must in the range of [0, 999999999].
70std::string PROTOBUF_EXPORT FormatTime(int64_t seconds, int32_t nanos);
71// Parses a time string. This method accepts RFC3339 date/time string with UTC
72// offset. For example, "2015-05-20T13:29:35.120-08:00".
73bool PROTOBUF_EXPORT ParseTime(const std::string& value, int64_t* seconds,
74 int32_t* nanos);
75
76} // namespace internal
77} // namespace protobuf
78} // namespace google
79
80#include <google/protobuf/port_undef.inc>
81
82#endif // GOOGLE_PROTOBUF_STUBS_TIME_H_
83