MySQL 8.4.3
Source Code Documentation
mysql_time.h
Go to the documentation of this file.
1/* Copyright (c) 2004, 2024, Oracle and/or its affiliates.
2
3 This program is free software; you can redistribute it and/or modify
4 it under the terms of the GNU General Public License, version 2.0,
5 as published by the Free Software Foundation.
6
7 This program is designed to work with certain software (including
8 but not limited to OpenSSL) that is licensed under separate terms,
9 as designated in a particular file or component or in included license
10 documentation. The authors of MySQL hereby grant you an additional
11 permission to link the program and your derivative works with the
12 separately licensed software that they have either included with
13 the program or referenced in the documentation.
14
15 Without limiting anything contained in the foregoing, this file,
16 which is part of C Driver for MySQL (Connector/C), is also subject to the
17 Universal FOSS Exception, version 1.0, a copy of which can be found at
18 http://oss.oracle.com/licenses/universal-foss-exception.
19
20 This program is distributed in the hope that it will be useful,
21 but WITHOUT ANY WARRANTY; without even the implied warranty of
22 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 GNU General Public License, version 2.0, for more details.
24
25 You should have received a copy of the GNU General Public License
26 along with this program; if not, write to the Free Software
27 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */
28
29#ifndef _mysql_time_h_
30#define _mysql_time_h_
31
32/**
33 @file include/mysql_time.h
34 Time declarations shared between the server and client API:
35 you should not add anything to this header unless it's used
36 (and hence should be visible) in mysql.h.
37 If you're looking for a place to add new time-related declaration,
38 it's most likely my_time.h. See also "C API Handling of Date
39 and Time Values" chapter in documentation.
40*/
41
42// Do not not pull in the server header "my_inttypes.h" from client code.
43// IWYU pragma: no_include "my_inttypes.h"
44
48
49 /// Stores year, month and day components.
51
52 /**
53 Stores all date and time components.
54 Value is in UTC for `TIMESTAMP` type.
55 Value is in local time zone for `DATETIME` type.
56 */
58
59 /// Stores hour, minute, second and microsecond.
61
62 /**
63 A temporary type for `DATETIME` or `TIMESTAMP` types equipped with time
64 zone information. After the time zone information is reconciled, the type is
65 converted to MYSQL_TIMESTAMP_DATETIME.
66 */
68};
69
70/*
71 Structure which is used to represent datetime values inside MySQL.
72
73 We assume that values in this structure are normalized, i.e. year <= 9999,
74 month <= 12, day <= 31, hour <= 23, hour <= 59, hour <= 59. Many functions
75 in server such as my_system_gmt_sec() or make_time() family of functions
76 rely on this (actually now usage of make_*() family relies on a bit weaker
77 restriction). Also functions that produce MYSQL_TIME as result ensure this.
78 There is one exception to this rule though if this structure holds time
79 value (time_type == MYSQL_TIMESTAMP_TIME) days and hour member can hold
80 bigger values.
81*/
82typedef struct MYSQL_TIME {
83 unsigned int year, month, day, hour, minute, second;
84 unsigned long second_part; /**< microseconds */
85 bool neg;
87 /// The time zone displacement, specified in seconds.
90
91#endif /* _mysql_time_h_ */
enum_mysql_timestamp_type
Definition: mysql_time.h:45
@ MYSQL_TIMESTAMP_TIME
Stores hour, minute, second and microsecond.
Definition: mysql_time.h:60
@ MYSQL_TIMESTAMP_ERROR
Definition: mysql_time.h:47
@ MYSQL_TIMESTAMP_DATETIME_TZ
A temporary type for DATETIME or TIMESTAMP types equipped with time zone information.
Definition: mysql_time.h:67
@ MYSQL_TIMESTAMP_DATETIME
Stores all date and time components.
Definition: mysql_time.h:57
@ MYSQL_TIMESTAMP_DATE
Stores year, month and day components.
Definition: mysql_time.h:50
@ MYSQL_TIMESTAMP_NONE
Definition: mysql_time.h:46
struct MYSQL_TIME MYSQL_TIME
Definition: mysql_time.h:82
int time_zone_displacement
The time zone displacement, specified in seconds.
Definition: mysql_time.h:88
unsigned long second_part
microseconds
Definition: mysql_time.h:84
unsigned int second
Definition: mysql_time.h:83
enum enum_mysql_timestamp_type time_type
Definition: mysql_time.h:86
unsigned int hour
Definition: mysql_time.h:83
unsigned int minute
Definition: mysql_time.h:83
unsigned int month
Definition: mysql_time.h:83
unsigned int day
Definition: mysql_time.h:83
bool neg
Definition: mysql_time.h:85
unsigned int year
Definition: mysql_time.h:83