| 1 | //! Time zones: which names the dependency update file's `timezone` may |
| 2 | //! use (the IANA database's, as `dependabot.yml` takes them), and how far |
| 3 | //! each is from UTC at a moment, which the runtime's `Intl` knows. |
| 4 | |
| 5 | /// Every name `schedule.timezone` accepts. |
| 6 | pub const ZONES: &[&str] = &[ |
| 7 | "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", |
| 8 | "Africa/Asmera", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", |
| 9 | "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", |
| 10 | "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", |
| 11 | "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", |
| 12 | "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", |
| 13 | "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", |
| 14 | "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", |
| 15 | "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", |
| 16 | "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", |
| 17 | "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", |
| 18 | "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", |
| 19 | "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", |
| 20 | "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", |
| 21 | "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", |
| 22 | "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", |
| 23 | "America/Atikokan", "America/Atka", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", |
| 24 | "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", |
| 25 | "America/Boise", "America/Buenos_Aires", "America/Cambridge_Bay", "America/Campo_Grande", |
| 26 | "America/Cancun", "America/Caracas", "America/Catamarca", "America/Cayenne", "America/Cayman", |
| 27 | "America/Chicago", "America/Chihuahua", "America/Ciudad_Juarez", "America/Coral_Harbour", |
| 28 | "America/Cordoba", "America/Costa_Rica", "America/Coyhaique", "America/Creston", "America/Cuiaba", |
| 29 | "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", |
| 30 | "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", |
| 31 | "America/Ensenada", "America/Fort_Nelson", "America/Fort_Wayne", "America/Fortaleza", "America/Glace_Bay", |
| 32 | "America/Godthab", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", |
| 33 | "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", |
| 34 | "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", |
| 35 | "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", |
| 36 | "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Indianapolis", "America/Inuvik", |
| 37 | "America/Iqaluit", "America/Jamaica", "America/Jujuy", "America/Juneau", "America/Kentucky/Louisville", |
| 38 | "America/Kentucky/Monticello", "America/Knox_IN", "America/Kralendijk", "America/La_Paz", "America/Lima", |
| 39 | "America/Los_Angeles", "America/Louisville", "America/Lower_Princes", "America/Maceio", "America/Managua", |
| 40 | "America/Manaus", "America/Marigot", "America/Martinique", "America/Matamoros", "America/Mazatlan", |
| 41 | "America/Mendoza", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", |
| 42 | "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", |
| 43 | "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", |
| 44 | "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", |
| 45 | "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", |
| 46 | "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", |
| 47 | "America/Port_of_Spain", "America/Porto_Acre", "America/Porto_Velho", "America/Puerto_Rico", |
| 48 | "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", |
| 49 | "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santa_Isabel", "America/Santarem", |
| 50 | "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", |
| 51 | "America/Shiprock", "America/Sitka", "America/St_Barthelemy", "America/St_Johns", "America/St_Kitts", |
| 52 | "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", |
| 53 | "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", |
| 54 | "America/Tortola", "America/Vancouver", "America/Virgin", "America/Whitehorse", "America/Winnipeg", |
| 55 | "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", |
| 56 | "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", |
| 57 | "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/South_Pole", "Antarctica/Syowa", |
| 58 | "Antarctica/Troll", "Antarctica/Vostok", "Arctic/Longyearbyen", "Asia/Aden", "Asia/Almaty", "Asia/Amman", |
| 59 | "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Ashkhabad", "Asia/Atyrau", |
| 60 | "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", |
| 61 | "Asia/Bishkek", "Asia/Brunei", "Asia/Calcutta", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", |
| 62 | "Asia/Chungking", "Asia/Colombo", "Asia/Dacca", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", |
| 63 | "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", |
| 64 | "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Istanbul", "Asia/Jakarta", "Asia/Jayapura", |
| 65 | "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", |
| 66 | "Asia/Katmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", |
| 67 | "Asia/Kuwait", "Asia/Macao", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", |
| 68 | "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", |
| 69 | "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Rangoon", |
| 70 | "Asia/Riyadh", "Asia/Saigon", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", |
| 71 | "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", |
| 72 | "Asia/Tel_Aviv", "Asia/Thimbu", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ujung_Pandang", |
| 73 | "Asia/Ulaanbaatar", "Asia/Ulan_Bator", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", |
| 74 | "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", |
| 75 | "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faeroe", |
| 76 | "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", |
| 77 | "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/ACT", "Australia/Adelaide", |
| 78 | "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Canberra", "Australia/Currie", |
| 79 | "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/LHI", "Australia/Lindeman", |
| 80 | "Australia/Lord_Howe", "Australia/Melbourne", "Australia/NSW", "Australia/North", "Australia/Perth", |
| 81 | "Australia/Queensland", "Australia/South", "Australia/Sydney", "Australia/Tasmania", "Australia/Victoria", |
| 82 | "Australia/West", "Australia/Yancowinna", "Brazil/Acre", "Brazil/DeNoronha", "Brazil/East", "Brazil/West", |
| 83 | "CET", "CST6CDT", "Canada/Atlantic", "Canada/Central", "Canada/Eastern", "Canada/Mountain", |
| 84 | "Canada/Newfoundland", "Canada/Pacific", "Canada/Saskatchewan", "Canada/Yukon", "Chile/Continental", |
| 85 | "Chile/EasterIsland", "Cuba", "EET", "EST", "EST5EDT", "Egypt", "Eire", "Etc/GMT", "Etc/GMT+0", |
| 86 | "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", |
| 87 | "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-0", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", |
| 88 | "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", |
| 89 | "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Etc/GMT0", "Etc/Greenwich", "Etc/UCT", "Etc/UTC", "Etc/Universal", |
| 90 | "Etc/Zulu", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", |
| 91 | "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", |
| 92 | "Europe/Budapest", "Europe/Busingen", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", |
| 93 | "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", |
| 94 | "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", |
| 95 | "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", |
| 96 | "Europe/Mariehamn", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Nicosia", "Europe/Oslo", |
| 97 | "Europe/Paris", "Europe/Podgorica", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", |
| 98 | "Europe/San_Marino", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", |
| 99 | "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", |
| 100 | "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vatican", "Europe/Vienna", |
| 101 | "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", |
| 102 | "Europe/Zurich", "GB", "GB-Eire", "GMT", "GMT+0", "GMT-0", "GMT0", "Greenwich", "HST", "Hongkong", |
| 103 | "Iceland", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", |
| 104 | "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", |
| 105 | "Indian/Reunion", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "MET", "MST", "MST7MDT", |
| 106 | "Mexico/BajaNorte", "Mexico/BajaSur", "Mexico/General", "NZ", "NZ-CHAT", "Navajo", "PRC", "PST8PDT", |
| 107 | "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", |
| 108 | "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", |
| 109 | "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", |
| 110 | "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", |
| 111 | "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", |
| 112 | "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", |
| 113 | "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Ponape", "Pacific/Port_Moresby", "Pacific/Rarotonga", |
| 114 | "Pacific/Saipan", "Pacific/Samoa", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", |
| 115 | "Pacific/Truk", "Pacific/Wake", "Pacific/Wallis", "Pacific/Yap", "Poland", "Portugal", "ROC", "ROK", |
| 116 | "Singapore", "Turkey", "UCT", "US/Alaska", "US/Aleutian", "US/Arizona", "US/Central", "US/East-Indiana", |
| 117 | "US/Eastern", "US/Hawaii", "US/Indiana-Starke", "US/Michigan", "US/Mountain", "US/Pacific", "US/Samoa", |
| 118 | "UTC", "Universal", "W-SU", "WET", "Zulu", |
| 119 | ]; |
| 120 | |
| 121 | pub fn known(zone: &str) -> bool { |
| 122 | ZONES.contains(&zone) |
| 123 | } |
| 124 | |
| 125 | /// How many minutes `zone` is ahead of UTC at `utc_ms`, from the |
| 126 | /// runtime's time zone database. UTC for a zone it does not know. |
| 127 | #[cfg(target_arch = "wasm32")] |
| 128 | pub fn offset_minutes(zone: &str, utc_ms: u64) -> i32 { |
| 129 | use worker::js_sys::{Array, Date, Intl, Object, Reflect}; |
| 130 | use worker::wasm_bindgen::JsValue; |
| 131 | if matches!(zone, "UTC" | "Etc/UTC" | "GMT" | "Etc/GMT" | "Zulu" | "Etc/Zulu" | "Universal" | "Etc/Universal") { |
| 132 | return 0; |
| 133 | } |
| 134 | let options = Object::new(); |
| 135 | let set = |key: &str, value: &str| { |
| 136 | let _ = Reflect::set(&options, &JsValue::from_str(key), &JsValue::from_str(value)); |
| 137 | }; |
| 138 | set("timeZone", zone); |
| 139 | set("hourCycle", "h23"); |
| 140 | for key in ["year", "month", "day", "hour", "minute", "second"] { |
| 141 | set(key, "numeric"); |
| 142 | } |
| 143 | let locales = Array::of1(&JsValue::from_str("en-US")); |
| 144 | let format = Intl::DateTimeFormat::new(&locales, &options); |
| 145 | let date = Date::new(&JsValue::from_f64(utc_ms as f64)); |
| 146 | let parts = format.format_to_parts(&date); |
| 147 | let mut fields = [0i64; 6]; |
| 148 | for part in parts.iter() { |
| 149 | let kind = Reflect::get(&part, &JsValue::from_str("type")).ok().and_then(|v| v.as_string()).unwrap_or_default(); |
| 150 | let value: i64 = Reflect::get(&part, &JsValue::from_str("value")) |
| 151 | .ok() |
| 152 | .and_then(|v| v.as_string()) |
| 153 | .and_then(|v| v.parse().ok()) |
| 154 | .unwrap_or(0); |
| 155 | let at = match kind.as_str() { |
| 156 | "year" => 0, |
| 157 | "month" => 1, |
| 158 | "day" => 2, |
| 159 | "hour" => 3, |
| 160 | "minute" => 4, |
| 161 | "second" => 5, |
| 162 | _ => continue, |
| 163 | }; |
| 164 | fields[at] = value; |
| 165 | } |
| 166 | let local = crate::schedule::days_from_civil(fields[0], fields[1] as u32, fields[2] as u32) * 86_400_000 |
| 167 | + (fields[3] % 24) * 3_600_000 |
| 168 | + fields[4] * 60_000 |
| 169 | + fields[5] * 1000; |
| 170 | let utc = (utc_ms / 1000 * 1000) as i64; |
| 171 | ((local - utc) / 60_000) as i32 |
| 172 | } |
| 173 | |
| 174 | /// Outside the Worker, for tests: UTC, fixed offsets, and a few zones with |
| 175 | /// their daylight saving rules, enough to test schedules across a change. |
| 176 | #[cfg(not(target_arch = "wasm32"))] |
| 177 | pub fn offset_minutes(zone: &str, utc_ms: u64) -> i32 { |
| 178 | use crate::schedule::{civil_from_days, days_from_civil}; |
| 179 | // The nth `weekday` (0 Sunday) of a month, or the last when n is 5, as a day number. |
| 180 | let nth = |year: i64, month: u32, weekday: i64, n: i64| -> i64 { |
| 181 | if n == 5 { |
| 182 | let next = if month == 12 { days_from_civil(year + 1, 1, 1) } else { days_from_civil(year, month + 1, 1) }; |
| 183 | let last = next - 1; |
| 184 | last - (last + 4 - weekday).rem_euclid(7) |
| 185 | } else { |
| 186 | let first = days_from_civil(year, month, 1); |
| 187 | first + (weekday - (first + 4)).rem_euclid(7) + 7 * (n - 1) |
| 188 | } |
| 189 | }; |
| 190 | let ms = utc_ms as i64; |
| 191 | let (year, _, _) = civil_from_days(ms.div_euclid(86_400_000)); |
| 192 | match zone { |
| 193 | "America/New_York" | "US/Eastern" => { |
| 194 | // Second Sunday of March, 07:00 UTC, to the first Sunday of November, 06:00 UTC. |
| 195 | let start = nth(year, 3, 0, 2) * 86_400_000 + 7 * 3_600_000; |
| 196 | let end = nth(year, 11, 0, 1) * 86_400_000 + 6 * 3_600_000; |
| 197 | if ms >= start && ms < end { -240 } else { -300 } |
| 198 | } |
| 199 | "Europe/London" => { |
| 200 | // Last Sunday of March to the last Sunday of October, 01:00 UTC. |
| 201 | let start = nth(year, 3, 0, 5) * 86_400_000 + 3_600_000; |
| 202 | let end = nth(year, 10, 0, 5) * 86_400_000 + 3_600_000; |
| 203 | if ms >= start && ms < end { 60 } else { 0 } |
| 204 | } |
| 205 | "Asia/Tokyo" | "Japan" => 540, |
| 206 | "Asia/Kolkata" | "Asia/Calcutta" => 330, |
| 207 | _ => 0, |
| 208 | } |
| 209 | } |
| 210 | |
| 211 | #[cfg(test)] |
| 212 | mod tests { |
| 213 | use super::*; |
| 214 | |
| 215 | #[test] |
| 216 | fn the_list_has_the_usual_zones() { |
| 217 | for zone in ["UTC", "America/New_York", "Europe/Berlin", "Asia/Kolkata", "Etc/GMT+5", "US/Pacific"] { |
| 218 | assert!(known(zone), "{zone}"); |
| 219 | } |
| 220 | assert!(!known("Mars/Olympus")); |
| 221 | assert!(!known("utc")); |
| 222 | } |
| 223 | |
| 224 | #[test] |
| 225 | fn test_offsets_follow_daylight_saving() { |
| 226 | let at = |text: &str| g1t_contracts::time::parse_rfc3339(text).unwrap(); |
| 227 | assert_eq!(offset_minutes("America/New_York", at("2026-01-15T12:00:00Z")), -300); |
| 228 | assert_eq!(offset_minutes("America/New_York", at("2026-07-15T12:00:00Z")), -240); |
| 229 | assert_eq!(offset_minutes("America/New_York", at("2026-03-08T06:59:00Z")), -300); |
| 230 | assert_eq!(offset_minutes("America/New_York", at("2026-03-08T07:00:00Z")), -240); |
| 231 | assert_eq!(offset_minutes("Europe/London", at("2026-10-25T00:59:00Z")), 60); |
| 232 | assert_eq!(offset_minutes("Europe/London", at("2026-10-25T01:00:00Z")), 0); |
| 233 | } |
| 234 | } |