DateTime for C++

Features

Quick Start

#include "GL_DateTime.hpp"
#include <iostream>
int main() {
 // Current time
 DateTime now = DateTime::Now();
 std::cout << "Now: " << now << std::endl;
 // Construct with specific date/time
 DateTime dt(2024, 12, 25, 10, 30, 0, 123);
 std::cout << dt.ToString("yyyy-MM-dd HH:mm:ss.fff") << std::endl;
 // Parse from string
 DateTime parsed = DateTime::Parse("2024年06月07日 14:30:00");
 // Date arithmetic with TimeSpan
 DateTime tomorrow = now.AddDays(1);
 TimeSpan diff = tomorrow - now;
 std::cout << "Hours until tomorrow: " << diff.GetTotalHours() << std::endl;
 return 0;
}

Building

g++ -std=c++20 -Iinclude your_program.cpp -o your_program

mingw32-make test # Build test/test.cpp
./build/test.exe # Run tests

API Reference

DateTime Constructors

DateTime Static Methods

DateTime Properties (Getters)

DateTime Arithmetic

DateTime Conversion

ToString Format

Predefined Format Specifiers

dt.ToString("d"); // "06/07/2024"
dt.ToString("D"); // "Friday, June 07, 2024"
dt.ToString("o"); // "2024-06-07T14:30:45.7890000"
dt.ToString("s"); // "2024-06-07T14:30:45"
dt.ToString("U"); // "Friday, June 07, 2024 06:30:45" (UTC)

Custom Format Specifiers

dt.ToString("yyyy-MM-dd HH:mm:ss"); // 2024年06月07日 14:05:03
dt.ToString("hh:mm tt"); // 02:05 PM
dt.ToString("dddd, MMMM d, yyyy"); // Friday, June 7, 2024
dt.ToString("yyyy'年'MM'月'dd'日'"); // 2024年06月07日
dt.ToString("yyyy-MM-dd HH:mm:ss.fff"); // 2024年06月07日 14:05:03.789
dt.ToShortDateString(); // 2024年06月07日
dt.ToLongDateString(); // Friday, June 07, 2024
dt.ToShortTimeString(); // 14:05
dt.ToLongTimeString(); // 14:05:03

Parse / TryParse

// Auto-detect common formats
DateTime dt = DateTime::Parse("2024年06月07日 14:30:00");
DateTime dt = DateTime::Parse("06/07/2024");
// Parse with explicit format
DateTime dt = DateTime::Parse("2024年06月07日 14:30:00", "yyyy/MM/dd HH:mm:ss");
DateTime dt = DateTime::Parse("06/07/2024 02:30:00 PM", "MM/dd/yyyy hh:mm:ss tt");
// Parse with predefined format shorthand
DateTime dt = DateTime::Parse("06/07/2024", "d"); // short date
DateTime dt = DateTime::Parse("2024年06月07日T14:30:00", "s"); // sortable
// TryParse (safe version)
DateTime result;
if (DateTime::TryParse("2024年06月07日", result)) {
 // Parsed successfully
}

DateTime Operators

dt1 + ts // DateTime + TimeSpan → DateTime
ts + dt1 // TimeSpan + DateTime → DateTime
dt1 - ts // DateTime - TimeSpan → DateTime
dt1 - dt2 // DateTime - DateTime → TimeSpan
dt1 == dt2 // equality
dt1 != dt2 // inequality
dt1 < dt2 // less than
dt1 <= dt2 // less than or equal
dt1 > dt2 // greater than
dt1 >= dt2 // greater than or equal

Stream Operators

DateTime dt = DateTime::Now();
std::cout << dt << std::endl; // Outputs: 2026年06月07日 18:24:20
std::cin >> dt; // Input: 2024年06月07日 14:30:00

TimeSpan

TimeSpan Constructors

TimeSpan Properties

TimeSpan Static Methods

TimeSpan::Zero() // TimeSpan(0)
TimeSpan::MinValue() // Minimum possible TimeSpan
TimeSpan::MaxValue() // Maximum possible TimeSpan
TimeSpan::FromDays(1.5) // 1.5 days → TimeSpan
TimeSpan::FromHours(2.5) // 2.5 hours → TimeSpan
// ... FromMinutes, FromSeconds, FromMilliseconds

TimeSpan Arithmetic

ts1 + ts2 // addition
ts1 - ts2 // subtraction
-ts1 // negation
ts1.Duration() // absolute value
ts1.CompareTo(ts2) // comparison

TimeSpan Operators

ts1 + ts2 // addition
ts1 - ts2 // subtraction
-ts1 // negation
ts1 == ts2 // equality
ts1 != ts2 // inequality
ts1 < ts2 // less than
ts1 <= ts2 // less than or equal
ts1 > ts2 // greater than
ts1 >= ts2 // greater than or equal

TimeSpan Formatting

TimeSpan ts(1, 2, 30, 0); // 1 day, 2 hours, 30 minutes
std::cout << ts; // Output: 1.02:30:00

DateTimeKind

enum class DateTimeKind {
 Unspecified = 0, // Default
 Utc = 1,
 Local = 2
};

Localization

#include <locale.h>
// Windows - US English
setlocale(LC_ALL, "English_United States.1252");
// Windows - Simplified Chinese
setlocale(LC_ALL, "Chinese (Simplified)_China.UTF-8");

Project Structure

DateTimeForCpp/
├── include/
│ └── GL_DateTime.hpp # Main file
├── test/
│ └── test.cpp # Test program
├── Makefile # Makefile
├── README.md # English Document
├── README_cn.md # Chinese Document
└── LICENSE

Differences from C# DateTime

License