reifydb_core/value/encoded/
datetime.rs

1// Copyright (c) reifydb.com 2025
2// This file is licensed under the AGPL-3.0-or-later, see license.md file
3
4use std::ptr;
5
6use reifydb_type::{DateTime, Type};
7
8use crate::value::encoded::{EncodedValues, EncodedValuesLayout};
9
10impl EncodedValuesLayout {
11	pub fn set_datetime(&self, row: &mut EncodedValues, index: usize, value: DateTime) {
12		let field = &self.fields[index];
13		debug_assert!(row.len() >= self.total_static_size());
14		debug_assert_eq!(field.r#type, Type::DateTime);
15		row.set_valid(index, true);
16
17		let (seconds, nanos) = value.to_parts();
18		unsafe {
19			// Write seconds at offset
20			ptr::write_unaligned(row.make_mut().as_mut_ptr().add(field.offset) as *mut i64, seconds);
21			// Write nanos at offset + 8
22			ptr::write_unaligned(row.make_mut().as_mut_ptr().add(field.offset + 8) as *mut u32, nanos);
23		}
24	}
25
26	pub fn get_datetime(&self, row: &EncodedValues, index: usize) -> DateTime {
27		let field = &self.fields[index];
28		debug_assert!(row.len() >= self.total_static_size());
29		debug_assert_eq!(field.r#type, Type::DateTime);
30		unsafe {
31			// Read i64 seconds at offset
32			let seconds = (row.as_ptr().add(field.offset) as *const i64).read_unaligned();
33			// Read u32 nanos at offset + 8
34			let nanos = (row.as_ptr().add(field.offset + 8) as *const u32).read_unaligned();
35			DateTime::from_parts(seconds, nanos).unwrap()
36		}
37	}
38
39	pub fn try_get_datetime(&self, row: &EncodedValues, index: usize) -> Option<DateTime> {
40		if row.is_defined(index) {
41			Some(self.get_datetime(row, index))
42		} else {
43			None
44		}
45	}
46}
47
48#[cfg(test)]
49mod tests {
50	use reifydb_type::{DateTime, Type};
51
52	use crate::value::encoded::EncodedValuesLayout;
53
54	#[test]
55	fn test_set_get_datetime() {
56		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
57		let mut row = layout.allocate();
58
59		let value = DateTime::new(2024, 9, 9, 08, 17, 0, 1234).unwrap();
60		layout.set_datetime(&mut row, 0, value.clone());
61		assert_eq!(layout.get_datetime(&row, 0), value);
62	}
63
64	#[test]
65	fn test_try_get_datetime() {
66		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
67		let mut row = layout.allocate();
68
69		assert_eq!(layout.try_get_datetime(&row, 0), None);
70
71		let test_datetime = DateTime::from_timestamp(1642694400).unwrap();
72		layout.set_datetime(&mut row, 0, test_datetime.clone());
73		assert_eq!(layout.try_get_datetime(&row, 0), Some(test_datetime));
74	}
75
76	#[test]
77	fn test_epoch() {
78		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
79		let mut row = layout.allocate();
80
81		let epoch = DateTime::default(); // Unix epoch
82		layout.set_datetime(&mut row, 0, epoch.clone());
83		assert_eq!(layout.get_datetime(&row, 0), epoch);
84	}
85
86	#[test]
87	fn test_with_nanoseconds() {
88		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
89		let mut row = layout.allocate();
90
91		// Test with high precision nanoseconds
92		let precise_datetime = DateTime::new(2024, 12, 25, 15, 30, 45, 123456789).unwrap();
93		layout.set_datetime(&mut row, 0, precise_datetime.clone());
94		assert_eq!(layout.get_datetime(&row, 0), precise_datetime);
95	}
96
97	#[test]
98	fn test_various_timestamps() {
99		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
100
101		let test_datetimes = [
102			DateTime::from_timestamp(0).unwrap(),          // Unix epoch
103			DateTime::from_timestamp(946684800).unwrap(),  // 2000-01-01
104			DateTime::from_timestamp(1640995200).unwrap(), // 2022-01-01
105			DateTime::from_timestamp(1735689600).unwrap(), // 2025-01-01
106		];
107
108		for datetime in test_datetimes {
109			let mut row = layout.allocate();
110			layout.set_datetime(&mut row, 0, datetime.clone());
111			assert_eq!(layout.get_datetime(&row, 0), datetime);
112		}
113	}
114
115	#[test]
116	fn test_negative_timestamps() {
117		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
118
119		// Test dates before Unix epoch
120		let pre_epoch_datetimes = [
121			DateTime::from_timestamp(-86400).unwrap(),    // 1969-12-31
122			DateTime::from_timestamp(-31536000).unwrap(), // 1969-01-01
123		];
124
125		for datetime in pre_epoch_datetimes {
126			let mut row = layout.allocate();
127			layout.set_datetime(&mut row, 0, datetime.clone());
128			assert_eq!(layout.get_datetime(&row, 0), datetime);
129		}
130	}
131
132	#[test]
133	fn test_mixed_with_other_types() {
134		let layout = EncodedValuesLayout::new(&[Type::DateTime, Type::Boolean, Type::DateTime, Type::Int8]);
135		let mut row = layout.allocate();
136
137		let datetime1 = DateTime::new(2025, 6, 15, 12, 0, 0, 0).unwrap();
138		let datetime2 = DateTime::new(1995, 3, 22, 18, 30, 45, 500000000).unwrap();
139
140		layout.set_datetime(&mut row, 0, datetime1.clone());
141		layout.set_bool(&mut row, 1, true);
142		layout.set_datetime(&mut row, 2, datetime2.clone());
143		layout.set_i64(&mut row, 3, 1234567890);
144
145		assert_eq!(layout.get_datetime(&row, 0), datetime1);
146		assert_eq!(layout.get_bool(&row, 1), true);
147		assert_eq!(layout.get_datetime(&row, 2), datetime2);
148		assert_eq!(layout.get_i64(&row, 3), 1234567890);
149	}
150
151	#[test]
152	fn test_undefined_handling() {
153		let layout = EncodedValuesLayout::new(&[Type::DateTime, Type::DateTime]);
154		let mut row = layout.allocate();
155
156		let datetime = DateTime::new(2025, 7, 4, 16, 20, 15, 750000000).unwrap();
157		layout.set_datetime(&mut row, 0, datetime.clone());
158
159		assert_eq!(layout.try_get_datetime(&row, 0), Some(datetime));
160		assert_eq!(layout.try_get_datetime(&row, 1), None);
161
162		layout.set_undefined(&mut row, 0);
163		assert_eq!(layout.try_get_datetime(&row, 0), None);
164	}
165
166	#[test]
167	fn test_precision_preservation() {
168		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
169		let mut row = layout.allocate();
170
171		// Test that nanosecond precision is preserved
172		let high_precision = DateTime::new(2024, 1, 1, 0, 0, 0, 999999999).unwrap();
173		layout.set_datetime(&mut row, 0, high_precision.clone());
174
175		let retrieved = layout.get_datetime(&row, 0);
176		assert_eq!(retrieved, high_precision);
177
178		let (orig_sec, orig_nanos) = high_precision.to_parts();
179		let (ret_sec, ret_nanos) = retrieved.to_parts();
180		assert_eq!(orig_sec, ret_sec);
181		assert_eq!(orig_nanos, ret_nanos);
182	}
183
184	#[test]
185	fn test_year_2038_problem() {
186		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
187		let mut row = layout.allocate();
188
189		// Test the Y2038 boundary (beyond 32-bit timestamp limits)
190		let post_2038 = DateTime::from_timestamp(2147483648).unwrap(); // 2038-01-19
191		layout.set_datetime(&mut row, 0, post_2038.clone());
192		assert_eq!(layout.get_datetime(&row, 0), post_2038);
193	}
194
195	#[test]
196	fn test_far_future() {
197		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
198		let mut row = layout.allocate();
199
200		// Test a far future date
201		let far_future = DateTime::from_timestamp(4102444800).unwrap(); // 2100-01-01
202		layout.set_datetime(&mut row, 0, far_future.clone());
203		assert_eq!(layout.get_datetime(&row, 0), far_future);
204	}
205
206	#[test]
207	fn test_microsecond_precision() {
208		let layout = EncodedValuesLayout::new(&[Type::DateTime]);
209		let mut row = layout.allocate();
210
211		// Test microsecond precision (common in databases)
212		let microsecond_precision = DateTime::new(2024, 6, 15, 14, 30, 25, 123456000).unwrap();
213		layout.set_datetime(&mut row, 0, microsecond_precision.clone());
214		assert_eq!(layout.get_datetime(&row, 0), microsecond_precision);
215	}
216}