pub(crate) const MAX_ZONE: usize = 64;
pub(crate) fn valid_name(name: &str) -> bool {
!name.is_empty()
&& name.len() <= MAX_ZONE
&& !name.contains("..")
&& !name.contains("//")
&& !name.starts_with('/')
&& !name.ends_with('/')
&& name
.bytes()
.all(|b| b.is_ascii_alphanumeric() || matches!(b, b'/' | b'_' | b'+' | b'-'))
}
pub(crate) fn from_env(value: &str) -> Option<&str> {
let name = value.strip_prefix(':').unwrap_or(value);
valid_name(name).then_some(name)
}
pub(crate) fn from_link(target: &str) -> Option<&str> {
let (_, rest) = target.rsplit_once("zoneinfo/")?;
let name = rest
.strip_prefix("posix/")
.or_else(|| rest.strip_prefix("right/"))
.unwrap_or(rest);
valid_name(name).then_some(name)
}
pub(crate) fn from_file(data: &[u8]) -> Option<&str> {
let line = data.split(|&b| b == b'\n').next()?;
let name = core::str::from_utf8(line.trim_ascii()).ok()?;
valid_name(name).then_some(name)
}
#[cfg_attr(not(any(windows, test, fuzzing)), allow(dead_code))]
pub(crate) fn iana_for_windows(name: &str) -> Option<&'static str> {
let at = WINDOWS_ZONES
.binary_search_by(|(w, _)| (*w).cmp(name))
.ok()?;
Some(WINDOWS_ZONES[at].1)
}
const WINDOWS_ZONES: &[(&str, &str)] = &[
("AUS Central Standard Time", "Australia/Darwin"),
("AUS Eastern Standard Time", "Australia/Sydney"),
("Afghanistan Standard Time", "Asia/Kabul"),
("Alaskan Standard Time", "America/Anchorage"),
("Aleutian Standard Time", "America/Adak"),
("Altai Standard Time", "Asia/Barnaul"),
("Arab Standard Time", "Asia/Riyadh"),
("Arabian Standard Time", "Asia/Dubai"),
("Arabic Standard Time", "Asia/Baghdad"),
("Argentina Standard Time", "America/Buenos_Aires"),
("Astrakhan Standard Time", "Europe/Astrakhan"),
("Atlantic Standard Time", "America/Halifax"),
("Aus Central W. Standard Time", "Australia/Eucla"),
("Azerbaijan Standard Time", "Asia/Baku"),
("Azores Standard Time", "Atlantic/Azores"),
("Bahia Standard Time", "America/Bahia"),
("Bangladesh Standard Time", "Asia/Dhaka"),
("Belarus Standard Time", "Europe/Minsk"),
("Bougainville Standard Time", "Pacific/Bougainville"),
("Canada Central Standard Time", "America/Regina"),
("Cape Verde Standard Time", "Atlantic/Cape_Verde"),
("Caucasus Standard Time", "Asia/Yerevan"),
("Cen. Australia Standard Time", "Australia/Adelaide"),
("Central America Standard Time", "America/Guatemala"),
("Central Asia Standard Time", "Asia/Almaty"),
("Central Brazilian Standard Time", "America/Cuiaba"),
("Central Europe Standard Time", "Europe/Budapest"),
("Central European Standard Time", "Europe/Warsaw"),
("Central Pacific Standard Time", "Pacific/Guadalcanal"),
("Central Standard Time", "America/Chicago"),
("Central Standard Time (Mexico)", "America/Mexico_City"),
("Chatham Islands Standard Time", "Pacific/Chatham"),
("China Standard Time", "Asia/Shanghai"),
("Cuba Standard Time", "America/Havana"),
("Dateline Standard Time", "Etc/GMT+12"),
("E. Africa Standard Time", "Africa/Nairobi"),
("E. Australia Standard Time", "Australia/Brisbane"),
("E. Europe Standard Time", "Europe/Chisinau"),
("E. South America Standard Time", "America/Sao_Paulo"),
("Easter Island Standard Time", "Pacific/Easter"),
("Eastern Standard Time", "America/New_York"),
("Eastern Standard Time (Mexico)", "America/Cancun"),
("Egypt Standard Time", "Africa/Cairo"),
("Ekaterinburg Standard Time", "Asia/Yekaterinburg"),
("FLE Standard Time", "Europe/Kiev"),
("Fiji Standard Time", "Pacific/Fiji"),
("GMT Standard Time", "Europe/London"),
("GTB Standard Time", "Europe/Bucharest"),
("Georgian Standard Time", "Asia/Tbilisi"),
("Greenland Standard Time", "America/Godthab"),
("Greenwich Standard Time", "Atlantic/Reykjavik"),
("Haiti Standard Time", "America/Port-au-Prince"),
("Hawaiian Standard Time", "Pacific/Honolulu"),
("India Standard Time", "Asia/Calcutta"),
("Iran Standard Time", "Asia/Tehran"),
("Israel Standard Time", "Asia/Jerusalem"),
("Jordan Standard Time", "Asia/Amman"),
("Kaliningrad Standard Time", "Europe/Kaliningrad"),
("Korea Standard Time", "Asia/Seoul"),
("Libya Standard Time", "Africa/Tripoli"),
("Line Islands Standard Time", "Pacific/Kiritimati"),
("Lord Howe Standard Time", "Australia/Lord_Howe"),
("Magadan Standard Time", "Asia/Magadan"),
("Magallanes Standard Time", "America/Punta_Arenas"),
("Marquesas Standard Time", "Pacific/Marquesas"),
("Mauritius Standard Time", "Indian/Mauritius"),
("Mid-Atlantic Standard Time", "Etc/GMT+2"),
("Middle East Standard Time", "Asia/Beirut"),
("Montevideo Standard Time", "America/Montevideo"),
("Morocco Standard Time", "Africa/Casablanca"),
("Mountain Standard Time", "America/Denver"),
("Mountain Standard Time (Mexico)", "America/Mazatlan"),
("Myanmar Standard Time", "Asia/Rangoon"),
("N. Central Asia Standard Time", "Asia/Novosibirsk"),
("Namibia Standard Time", "Africa/Windhoek"),
("Nepal Standard Time", "Asia/Katmandu"),
("New Zealand Standard Time", "Pacific/Auckland"),
("Newfoundland Standard Time", "America/St_Johns"),
("Norfolk Standard Time", "Pacific/Norfolk"),
("North Asia East Standard Time", "Asia/Irkutsk"),
("North Asia Standard Time", "Asia/Krasnoyarsk"),
("North Korea Standard Time", "Asia/Pyongyang"),
("Omsk Standard Time", "Asia/Omsk"),
("Pacific SA Standard Time", "America/Santiago"),
("Pacific Standard Time", "America/Los_Angeles"),
("Pacific Standard Time (Mexico)", "America/Tijuana"),
("Pakistan Standard Time", "Asia/Karachi"),
("Paraguay Standard Time", "America/Asuncion"),
("Qyzylorda Standard Time", "Asia/Qyzylorda"),
("Romance Standard Time", "Europe/Paris"),
("Russia Time Zone 10", "Asia/Srednekolymsk"),
("Russia Time Zone 11", "Asia/Kamchatka"),
("Russia Time Zone 3", "Europe/Samara"),
("Russian Standard Time", "Europe/Moscow"),
("SA Eastern Standard Time", "America/Cayenne"),
("SA Pacific Standard Time", "America/Bogota"),
("SA Western Standard Time", "America/La_Paz"),
("SE Asia Standard Time", "Asia/Bangkok"),
("Saint Pierre Standard Time", "America/Miquelon"),
("Sakhalin Standard Time", "Asia/Sakhalin"),
("Samoa Standard Time", "Pacific/Apia"),
("Sao Tome Standard Time", "Africa/Sao_Tome"),
("Saratov Standard Time", "Europe/Saratov"),
("Singapore Standard Time", "Asia/Singapore"),
("South Africa Standard Time", "Africa/Johannesburg"),
("South Sudan Standard Time", "Africa/Juba"),
("Sri Lanka Standard Time", "Asia/Colombo"),
("Sudan Standard Time", "Africa/Khartoum"),
("Syria Standard Time", "Asia/Damascus"),
("Taipei Standard Time", "Asia/Taipei"),
("Tasmania Standard Time", "Australia/Hobart"),
("Tocantins Standard Time", "America/Araguaina"),
("Tokyo Standard Time", "Asia/Tokyo"),
("Tomsk Standard Time", "Asia/Tomsk"),
("Tonga Standard Time", "Pacific/Tongatapu"),
("Transbaikal Standard Time", "Asia/Chita"),
("Turkey Standard Time", "Europe/Istanbul"),
("Turks And Caicos Standard Time", "America/Grand_Turk"),
("US Eastern Standard Time", "America/Indianapolis"),
("US Mountain Standard Time", "America/Phoenix"),
("UTC", "Etc/UTC"),
("UTC+12", "Etc/GMT-12"),
("UTC+13", "Etc/GMT-13"),
("UTC-02", "Etc/GMT+2"),
("UTC-08", "Etc/GMT+8"),
("UTC-09", "Etc/GMT+9"),
("UTC-11", "Etc/GMT+11"),
("Ulaanbaatar Standard Time", "Asia/Ulaanbaatar"),
("Venezuela Standard Time", "America/Caracas"),
("Vladivostok Standard Time", "Asia/Vladivostok"),
("Volgograd Standard Time", "Europe/Volgograd"),
("W. Australia Standard Time", "Australia/Perth"),
("W. Central Africa Standard Time", "Africa/Lagos"),
("W. Europe Standard Time", "Europe/Berlin"),
("W. Mongolia Standard Time", "Asia/Hovd"),
("West Asia Standard Time", "Asia/Tashkent"),
("West Bank Standard Time", "Asia/Hebron"),
("West Pacific Standard Time", "Pacific/Port_Moresby"),
("Yakutsk Standard Time", "Asia/Yakutsk"),
("Yukon Standard Time", "America/Whitehorse"),
];
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_tz_env_values() {
assert_eq!(from_env("Europe/London"), Some("Europe/London"));
assert_eq!(from_env(":Europe/London"), Some("Europe/London"));
assert_eq!(
from_env("America/Port-au-Prince"),
Some("America/Port-au-Prince")
);
assert_eq!(from_env("Etc/GMT+5"), Some("Etc/GMT+5"));
for v in [
"",
":",
"../../etc/shadow",
"/etc/shadow",
":/etc/shadow",
"Europe/../London",
"Europe//London",
"Europe/",
"a b",
"x\ny",
"x\0y",
] {
assert_eq!(from_env(v), None, "{v:?}");
}
assert_eq!(from_env(&"a".repeat(MAX_ZONE + 1)), None);
}
#[test]
fn test_tz_link_targets() {
for (target, want) in [
("/usr/share/zoneinfo/Europe/London", Some("Europe/London")),
("../usr/share/zoneinfo/Asia/Tokyo", Some("Asia/Tokyo")),
("/usr/share/zoneinfo/posix/UTC", Some("UTC")),
("/usr/share/zoneinfo/right/UTC", Some("UTC")),
(
"/var/db/timezone/zoneinfo/America/New_York",
Some("America/New_York"),
),
("/etc/some-copy", None),
("/usr/share/zoneinfo/", None),
("/usr/share/zoneinfo/../../../etc/shadow", None),
] {
assert_eq!(from_link(target), want, "{target}");
}
}
#[test]
fn test_tz_file() {
assert_eq!(from_file(b"Etc/UTC\n"), Some("Etc/UTC"));
assert_eq!(from_file(b" Asia/Tokyo \nignored"), Some("Asia/Tokyo"));
assert_eq!(from_file(b""), None);
assert_eq!(from_file(b"\xff\xfe"), None);
}
#[test]
fn test_tz_windows_table_is_sorted_and_valid() {
for pair in WINDOWS_ZONES.windows(2) {
assert!(pair[0].0 < pair[1].0, "{} before {}", pair[0].0, pair[1].0);
}
for (_, iana) in WINDOWS_ZONES {
assert!(valid_name(iana), "{iana}");
}
assert_eq!(iana_for_windows("GMT Standard Time"), Some("Europe/London"));
assert_eq!(
iana_for_windows("Pacific Standard Time"),
Some("America/Los_Angeles")
);
assert_eq!(iana_for_windows("UTC"), Some("Etc/UTC"));
assert_eq!(iana_for_windows("Not A Zone"), None);
}
}