gazugafan/laravel-timezone
Composer 安装命令：
composer require gazugafan/laravel-timezone
包简介
Date/time timezone storage and retrieval for Laravel 5
关键字：
README 文档
README
Date/time timezone storage and retrieval for Laravel 5
A simple set of functions to assist in converting date/times between a global storage timezone, and a user's local timezone.
Requirements
- This has been unit tested on Laravel 5.4 with PHP 7.1, but I believe it should work with older versions as well. Let me know if you find that it does!
Installation
Install via Composer...
composer require gazugafan/laravel-timezone
Add the service provider to the providers array in config/app.php...
'providers' => [ ... \Gazugafan\Timezone\TimezoneServiceProvider::class ];
And add an alias to the aliases array in config/app.php...
'aliases' => [ ... 'Timezone' => Gazugafan\Timezone\Facades\Timezone::class ];
Overview
If your application is timezone-aware, you'll want to be converting all of your date/times to a single global timezone before storing them in the database. Then, when you retrieve these date/times, you'll want to convert them to the currently-logged-in user's local timezone before displaying them. This Timezone class contains a simple set of methods for doing just that!
Setup
First, you need to decide what global timezone you'll be using to store your date/times in. Most people recommend using UTC for this storage timezone, which is fair because it's commonly-used and somewhat expected. It really doesn't matter, though--so long as you pick one timezone and never change it. Personally, I recommend using whatever timezone you (or your DBA) is in. This way, when manually querying or browsing the database, you'll be seeing dates in your own timezone instead of UTC, which will probably be much easier to work with.
Got your storage timezone figured out? Good! Fill it into the timezone entry in config/app.php. It's the only place you'll need to specify it...
'timezone' => 'America/Chicago',
Next, you'll need to figure out how your user's timezone will be specified. A pretty straightforward way to do this would be adding a timezone field to your user's table. By default, these helper methods will assume that's what you've done, and will retrieve the currently-logged-in user's timezone like this...
Auth::user()->timezone
If you need help coming up with a list of timezones for your users to select from, here's a set of options you could use in a dropdown...
A whole bunch of options
<option value="America/New_York">America, Eastern</option> <option value="America/Chicago">America, Central</option> <option value="America/Denver">America, Mountain</option> <option value="America/Phoenix">America, Mountain (no DST)</option> <option value="America/Los_Angeles">America, Pacific</option> <option value="America/Anchorage">America, Alaska</option> <option value="America/Adak">America, Hawaii</option> <option value="Pacific/Honolulu">Pacific, Hawaii (no DST)</option> <option value="Pacific/Midway">Pacific, Midway (GMT-11:00)</option> <option value="Pacific/Niue">Pacific, Niue (GMT-11:00)</option> <option value="Pacific/Pago_Pago">Pacific, Pago Pago (GMT-11:00)</option> <option value="Pacific/Honolulu">Pacific, Honolulu (GMT-10:00)</option> <option value="Pacific/Johnston">Pacific, Johnston (GMT-10:00)</option> <option value="Pacific/Rarotonga">Pacific, Rarotonga (GMT-10:00)</option> <option value="Pacific/Tahiti">Pacific, Tahiti (GMT-10:00)</option> <option value="Pacific/Marquesas">Pacific, Marquesas (GMT-09:30)</option> <option value="America/Adak">America, Adak (GMT-09:00)</option> <option value="Pacific/Gambier">Pacific, Gambier (GMT-09:00)</option> <option value="America/Anchorage">America, Anchorage (GMT-08:00)</option> <option value="America/Juneau">America, Juneau (GMT-08:00)</option> <option value="America/Metlakatla">America, Metlakatla (GMT-08:00)</option> <option value="America/Nome">America, Nome (GMT-08:00)</option> <option value="America/Sitka">America, Sitka (GMT-08:00)</option> <option value="America/Yakutat">America, Yakutat (GMT-08:00)</option> <option value="Pacific/Pitcairn">Pacific, Pitcairn (GMT-08:00)</option> <option value="America/Creston">America, Creston (GMT-07:00)</option> <option value="America/Dawson">America, Dawson (GMT-07:00)</option> <option value="America/Dawson_Creek">America, Dawson Creek (GMT-07:00)</option> <option value="America/Fort_Nelson">America, Fort Nelson (GMT-07:00)</option> <option value="America/Hermosillo">America, Hermosillo (GMT-07:00)</option> <option value="America/Los_Angeles">America, Los Angeles (GMT-07:00)</option> <option value="America/Phoenix">America, Phoenix (GMT-07:00)</option> <option value="America/Tijuana">America, Tijuana (GMT-07:00)</option> <option value="America/Vancouver">America, Vancouver (GMT-07:00)</option> <option value="America/Whitehorse">America, Whitehorse (GMT-07:00)</option> <option value="America/Belize">America, Belize (GMT-06:00)</option> <option value="America/Boise">America, Boise (GMT-06:00)</option> <option value="America/Cambridge_Bay">America, Cambridge Bay (GMT-06:00)</option> <option value="America/Chihuahua">America, Chihuahua (GMT-06:00)</option> <option value="America/Costa_Rica">America, Costa Rica (GMT-06:00)</option> <option value="America/Denver">America, Denver (GMT-06:00)</option> <option value="America/Edmonton">America, Edmonton (GMT-06:00)</option> <option value="America/El_Salvador">America, El Salvador (GMT-06:00)</option> <option value="America/Guatemala">America, Guatemala (GMT-06:00)</option> <option value="America/Inuvik">America, Inuvik (GMT-06:00)</option> <option value="America/Managua">America, Managua (GMT-06:00)</option> <option value="America/Mazatlan">America, Mazatlan (GMT-06:00)</option> <option value="America/Ojinaga">America, Ojinaga (GMT-06:00)</option> <option value="America/Regina">America, Regina (GMT-06:00)</option> <option value="America/Swift_Current">America, Swift Current (GMT-06:00)</option> <option value="America/Tegucigalpa">America, Tegucigalpa (GMT-06:00)</option> <option value="America/Yellowknife">America, Yellowknife (GMT-06:00)</option> <option value="Pacific/Galapagos">Pacific, Galapagos (GMT-06:00)</option> <option value="America/Atikokan">America, Atikokan (GMT-05:00)</option> <option value="America/Bahia_Banderas">America, Bahia Banderas (GMT-05:00)</option> <option value="America/Bogota">America, Bogota (GMT-05:00)</option> <option value="America/Cancun">America, Cancun (GMT-05:00)</option> <option value="America/Cayman">America, Cayman (GMT-05:00)</option> <option value="America/Chicago">America, Chicago (GMT-05:00)</option> <option value="America/Eirunepe">America, Eirunepe (GMT-05:00)</option> <option value="America/Guayaquil">America, Guayaquil (GMT-05:00)</option> <option value="America/Indiana/Knox">America, Indiana, Knox (GMT-05:00)</option> <option value="America/Indiana/Tell_City">America, Indiana, Tell City (GMT-05:00)</option> <option value="America/Jamaica">America, Jamaica (GMT-05:00)</option> <option value="America/Lima">America, Lima (GMT-05:00)</option> <option value="America/Matamoros">America, Matamoros (GMT-05:00)</option> <option value="America/Menominee">America, Menominee (GMT-05:00)</option> <option value="America/Merida">America, Merida (GMT-05:00)</option> <option value="America/Mexico_City">America, Mexico City (GMT-05:00)</option> <option value="America/Monterrey">America, Monterrey (GMT-05:00)</option> <option value="America/North_Dakota/Beulah">America, North Dakota, Beulah (GMT-05:00)</option> <option value="America/North_Dakota/Center">America, North Dakota, Center (GMT-05:00)</option> <option value="America/North_Dakota/New_Salem">America, North Dakota, New Salem (GMT-05:00)</option> <option value="America/Panama">America, Panama (GMT-05:00)</option> <option value="America/Port-au-Prince">America, Port-au-Prince (GMT-05:00)</option> <option value="America/Rainy_River">America, Rainy River (GMT-05:00)</option> <option value="America/Rankin_Inlet">America, Rankin Inlet (GMT-05:00)</option> <option value="America/Resolute">America, Resolute (GMT-05:00)</option> <option value="America/Rio_Branco">America, Rio Branco (GMT-05:00)</option> <option value="America/Winnipeg">America, Winnipeg (GMT-05:00)</option> <option value="Pacific/Easter">Pacific, Easter (GMT-05:00)</option> <option value="America/Anguilla">America, Anguilla (GMT-04:00)</option> <option value="America/Antigua">America, Antigua (GMT-04:00)</option> <option value="America/Aruba">America, Aruba (GMT-04:00)</option> <option value="America/Asuncion">America, Asuncion (GMT-04:00)</option> <option value="America/Barbados">America, Barbados (GMT-04:00)</option> <option value="America/Blanc-Sablon">America, Blanc-Sablon (GMT-04:00)</option> <option value="America/Boa_Vista">America, Boa Vista (GMT-04:00)</option> <option value="America/Campo_Grande">America, Campo Grande (GMT-04:00)</option> <option value="America/Caracas">America, Caracas (GMT-04:00)</option> <option value="America/Cuiaba">America, Cuiaba (GMT-04:00)</option> <option value="America/Curacao">America, Curacao (GMT-04:00)</option> <option value="America/Detroit">America, Detroit (GMT-04:00)</option> <option value="America/Dominica">America, Dominica (GMT-04:00)</option> <option value="America/Grand_Turk">America, Grand Turk (GMT-04:00)</option> <option value="America/Grenada">America, Grenada (GMT-04:00)</option> <option value="America/Guadeloupe">America, Guadeloupe (GMT-04:00)</option> <option value="America/Guyana">America, Guyana (GMT-04:00)</option> <option value="America/Havana">America, Havana (GMT-04:00)</option> <option value="America/Indiana/Indianapolis">America, Indiana, Indianapolis (GMT-04:00)</option> <option value="America/Indiana/Marengo">America, Indiana, Marengo (GMT-04:00)</option> <option value="America/Indiana/Petersburg">America, Indiana, Petersburg (GMT-04:00)</option> <option value="America/Indiana/Vevay">America, Indiana, Vevay (GMT-04:00)</option> <option value="America/Indiana/Vincennes">America, Indiana, Vincennes (GMT-04:00)</option> <option value="America/Indiana/Winamac">America, Indiana, Winamac (GMT-04:00)</option> <option value="America/Iqaluit">America, Iqaluit (GMT-04:00)</option> <option value="America/Kentucky/Louisville">America, Kentucky, Louisville (GMT-04:00)</option> <option value="America/Kentucky/Monticello">America, Kentucky, Monticello (GMT-04:00)</option> <option value="America/Kralendijk">America, Kralendijk (GMT-04:00)</option> <option value="America/La_Paz">America, La Paz (GMT-04:00)</option> <option value="America/Lower_Princes">America, Lower Princes (GMT-04:00)</option> <option value="America/Manaus">America, Manaus (GMT-04:00)</option> <option value="America/Marigot">America, Marigot (GMT-04:00)</option> <option value="America/Martinique">America, Martinique (GMT-04:00)</option> <option value="America/Montserrat">America, Montserrat (GMT-04:00)</option> <option value="America/Nassau">America, Nassau (GMT-04:00)</option> <option value="America/New_York">America, New York (GMT-04:00)</option> <option value="America/Nipigon">America, Nipigon (GMT-04:00)</option> <option value="America/Pangnirtung">America, Pangnirtung (GMT-04:00)</option> <option value="America/Port_of_Spain">America, Port of Spain (GMT-04:00)</option> <option value="America/Porto_Velho">America, Porto Velho (GMT-04:00)</option> <option value="America/Puerto_Rico">America, Puerto Rico (GMT-04:00)</option> <option value="America/Santo_Domingo">America, Santo Domingo (GMT-04:00)</option> <option value="America/St_Barthelemy">America, St. Barthelemy (GMT-04:00)</option> <option value="America/St_Kitts">America, St. Kitts (GMT-04:00)</option> <option value="America/St_Lucia">America, St. Lucia (GMT-04:00)</option> <option value="America/St_Thomas">America, St. Thomas (GMT-04:00)</option> <option value="America/St_Vincent">America, St. Vincent (GMT-04:00)</option> <option value="America/Thunder_Bay">America, Thunder Bay (GMT-04:00)</option> <option value="America/Toronto">America, Toronto (GMT-04:00)</option> <option value="America/Tortola">America, Tortola (GMT-04:00)</option> <option value="America/Araguaina">America, Araguaina (GMT-03:00)</option> <option value="America/Argentina/Buenos_Aires">America, Argentina, Buenos Aires (GMT-03:00)</option> <option value="America/Argentina/Catamarca">America, Argentina, Catamarca (GMT-03:00)</option> <option value="America/Argentina/Cordoba">America, Argentina, Cordoba (GMT-03:00)</option> <option value="America/Argentina/Jujuy">America, Argentina, Jujuy (GMT-03:00)</option> <option value="America/Argentina/La_Rioja">America, Argentina, La Rioja (GMT-03:00)</option> <option value="America/Argentina/Mendoza">America, Argentina, Mendoza (GMT-03:00)</option> <option value="America/Argentina/Rio_Gallegos">America, Argentina, Rio Gallegos (GMT-03:00)</option> <option value="America/Argentina/Salta">America, Argentina, Salta (GMT-03:00)</option> <option value="America/Argentina/San_Juan">America, Argentina, San Juan (GMT-03:00)</option> <option value="America/Argentina/San_Luis">America, Argentina, San Luis (GMT-03:00)</option> <option value="America/Argentina/Tucuman">America, Argentina, Tucuman (GMT-03:00)</option> <option value="America/Argentina/Ushuaia">America, Argentina, Ushuaia (GMT-03:00)</option> <option value="America/Bahia">America, Bahia (GMT-03:00)</option> <option value="America/Belem">America, Belem (GMT-03:00)</option> <option value="America/Cayenne">America, Cayenne (GMT-03:00)</option> <option value="America/Fortaleza">America, Fortaleza (GMT-03:00)</option> <option value="America/Glace_Bay">America, Glace Bay (GMT-03:00)</option> <option value="America/Goose_Bay">America, Goose Bay (GMT-03:00)</option> <option value="America/Halifax">America, Halifax (GMT-03:00)</option> <option value="America/Maceio">America, Maceio (GMT-03:00)</option> <option value="America/Moncton">America, Moncton (GMT-03:00)</option> <option value="America/Montevideo">America, Montevideo (GMT-03:00)</option> <option value="America/Paramaribo">America, Paramaribo (GMT-03:00)</option> <option value="America/Recife">America, Recife (GMT-03:00)</option> <option value="America/Santarem">America, Santarem (GMT-03:00)</option> <option value="America/Santiago">America, Santiago (GMT-03:00)</option> <option value="America/Sao_Paulo">America, Sao Paulo (GMT-03:00)</option> <option value="America/Thule">America, Thule (GMT-03:00)</option> <option value="Antarctica/Palmer">Antarctica, Palmer (GMT-03:00)</option> <option value="Antarctica/Rothera">Antarctica, Rothera (GMT-03:00)</option> <option value="Atlantic/Bermuda">Atlantic, Bermuda (GMT-03:00)</option> <option value="Atlantic/Stanley">Atlantic, Stanley (GMT-03:00)</option> <option value="America/St_Johns">America, St. Johns (GMT-02:30)</option> <option value="America/Godthab">America, Godthab (GMT-02:00)</option> <option value="America/Miquelon">America, Miquelon (GMT-02:00)</option> <option value="America/Noronha">America, Noronha (GMT-02:00)</option> <option value="Atlantic/South_Georgia">Atlantic, South Georgia (GMT-02:00)</option> <option value="Atlantic/Cape_Verde">Atlantic, Cape Verde (GMT-01:00)</option> <option value="Africa/Abidjan">Africa, Abidjan (GMT)</option> <option value="Africa/Accra">Africa, Accra (GMT)</option> <option value="Africa/Bamako">Africa, Bamako (GMT)</option> <option value="Africa/Banjul">Africa, Banjul (GMT)</option> <option value="Africa/Bissau">Africa, Bissau (GMT)</option> <option value="Africa/Conakry">Africa, Conakry (GMT)</option> <option value="Africa/Dakar">Africa, Dakar (GMT)</option> <option value="Africa/Freetown">Africa, Freetown (GMT)</option> <option value="Africa/Lome">Africa, Lome (GMT)</option> <option value="Africa/Monrovia">Africa, Monrovia (GMT)</option> <option value="Africa/Nouakchott">Africa, Nouakchott (GMT)</option> <option value="Africa/Ouagadougou">Africa, Ouagadougou (GMT)</option> <option value="Africa/Sao_Tome">Africa, Sao Tome (GMT)</option> <option value="America/Danmarkshavn">America, Danmarkshavn (GMT)</option> <option value="America/Scoresbysund">America, Scoresbysund (GMT)</option> <option value="Atlantic/Azores">Atlantic, Azores (GMT)</option> <option value="Atlantic/Reykjavik">Atlantic, Reykjavik (GMT)</option> <option value="Atlantic/St_Helena">Atlantic, St. Helena (GMT)</option> <option value="UTC">UTC (GMT)</option> <option value="Africa/Algiers">Africa, Algiers (GMT+01:00)</option> <option value="Africa/Bangui">Africa, Bangui (GMT+01:00)</option> <option value="Africa/Brazzaville">Africa, Brazzaville (GMT+01:00)</option> <option value="Africa/Casablanca">Africa, Casablanca (GMT+01:00)</option> <option value="Africa/Douala">Africa, Douala (GMT+01:00)</option> <option value="Africa/El_Aaiun">Africa, El Aaiun (GMT+01:00)</option> <option value="Africa/Kinshasa">Africa, Kinshasa (GMT+01:00)</option> <option value="Africa/Lagos">Africa, Lagos (GMT+01:00)</option> <option value="Africa/Libreville">Africa, Libreville (GMT+01:00)</option> <option value="Africa/Luanda">Africa, Luanda (GMT+01:00)</option> <option value="Africa/Malabo">Africa, Malabo (GMT+01:00)</option> <option value="Africa/Ndjamena">Africa, Ndjamena (GMT+01:00)</option> <option value="Africa/Niamey">Africa, Niamey (GMT+01:00)</option> <option value="Africa/Porto-Novo">Africa, Porto-Novo (GMT+01:00)</option> <option value="Africa/Tunis">Africa, Tunis (GMT+01:00)</option> <option value="Africa/Windhoek">Africa, Windhoek (GMT+01:00)</option> <option value="Atlantic/Canary">Atlantic, Canary (GMT+01:00)</option> <option value="Atlantic/Faroe">Atlantic, Faroe (GMT+01:00)</option> <option value="Atlantic/Madeira">Atlantic, Madeira (GMT+01:00)</option> <option value="Europe/Dublin">Europe, Dublin (GMT+01:00)</option> <option value="Europe/Guernsey">Europe, Guernsey (GMT+01:00)</option> <option value="Europe/Isle_of_Man">Europe, Isle of Man (GMT+01:00)</option> <option value="Europe/Jersey">Europe, Jersey (GMT+01:00)</option> <option value="Europe/Lisbon">Europe, Lisbon (GMT+01:00)</option> <option value="Europe/London">Europe, London (GMT+01:00)</option> <option value="Africa/Blantyre">Africa, Blantyre (GMT+02:00)</option> <option value="Africa/Bujumbura">Africa, Bujumbura (GMT+02:00)</option> <option value="Africa/Cairo">Africa, Cairo (GMT+02:00)</option> <option value="Africa/Ceuta">Africa, Ceuta (GMT+02:00)</option> <option value="Africa/Gaborone">Africa, Gaborone (GMT+02:00)</option> <option value="Africa/Harare">Africa, Harare (GMT+02:00)</option> <option value="Africa/Johannesburg">Africa, Johannesburg (GMT+02:00)</option> <option value="Africa/Kigali">Africa, Kigali (GMT+02:00)</option> <option value="Africa/Lubumbashi">Africa, Lubumbashi (GMT+02:00)</option> <option value="Africa/Lusaka">Africa, Lusaka (GMT+02:00)</option> <option value="Africa/Maputo">Africa, Maputo (GMT+02:00)</option> <option value="Africa/Maseru">Africa, Maseru (GMT+02:00)</option> <option value="Africa/Mbabane">Africa, Mbabane (GMT+02:00)</option> <option value="Africa/Tripoli">Africa, Tripoli (GMT+02:00)</option> <option value="Antarctica/Troll">Antarctica, Troll (GMT+02:00)</option> <option value="Arctic/Longyearbyen">Arctic, Longyearbyen (GMT+02:00)</option> <option value="Europe/Amsterdam">Europe, Amsterdam (GMT+02:00)</option> <option value="Europe/Andorra">Europe, Andorra (GMT+02:00)</option> <option value="Europe/Belgrade">Europe, Belgrade (GMT+02:00)</option> <option value="Europe/Berlin">Europe, Berlin (GMT+02:00)</option> <option value="Europe/Bratislava">Europe, Bratislava (GMT+02:00)</option> <option value="Europe/Brussels">Europe, Brussels (GMT+02:00)</option> <option value="Europe/Budapest">Europe, Budapest (GMT+02:00)</option> <option value="Europe/Busingen">Europe, Busingen (GMT+02:00)</option> <option value="Europe/Copenhagen">Europe, Copenhagen (GMT+02:00)</option> <option value="Europe/Gibraltar">Europe, Gibraltar (GMT+02:00)</option> <option value="Europe/Kaliningrad">Europe, Kaliningrad (GMT+02:00)</option> <option value="Europe/Ljubljana">Europe, Ljubljana (GMT+02:00)</option> <option value="Europe/Luxembourg">Europe, Luxembourg (GMT+02:00)</option> <option value="Europe/Madrid">Europe, Madrid (GMT+02:00)</option> <option value="Europe/Malta">Europe, Malta (GMT+02:00)</option> <option value="Europe/Monaco">Europe, Monaco (GMT+02:00)</option> <option value="Europe/Oslo">Europe, Oslo (GMT+02:00)</option> <option value="Europe/Paris">Europe, Paris (GMT+02:00)</option> <option value="Europe/Podgorica">Europe, Podgorica (GMT+02:00)</option> <option value="Europe/Prague">Europe, Prague (GMT+02:00)</option> <option value="Europe/Rome">Europe, Rome (GMT+02:00)</option> <option value="Europe/San_Marino">Europe, San Marino (GMT+02:00)</option> <option value="Europe/Sarajevo">Europe, Sarajevo (GMT+02:00)</option> <option value="Europe/Skopje">Europe, Skopje (GMT+02:00)</option> <option value="Europe/Stockholm">Europe, Stockholm (GMT+02:00)</option> <option value="Europe/Tirane">Europe, Tirane (GMT+02:00)</option> <option value="Europe/Vaduz">Europe, Vaduz (GMT+02:00)</option> <option value="Europe/Vatican">Europe, Vatican (GMT+02:00)</option> <option value="Europe/Vienna">Europe, Vienna (GMT+02:00)</option> <option value="Europe/Warsaw">Europe, Warsaw (GMT+02:00)</option> <option value="Europe/Zagreb">Europe, Zagreb (GMT+02:00)</option> <option value="Europe/Zurich">Europe, Zurich (GMT+02:00)</option> <option value="Africa/Addis_Ababa">Africa, Addis Ababa (GMT+03:00)</option> <option value="Africa/Asmara">Africa, Asmara (GMT+03:00)</option> <option value="Africa/Dar_es_Salaam">Africa, Dar es Salaam (GMT+03:00)</option> <option value="Africa/Djibouti">Africa, Djibouti (GMT+03:00)</option> <option value="Africa/Juba">Africa, Juba (GMT+03:00)</option> <option value="Africa/Kampala">Africa, Kampala (GMT+03:00)</option> <option value="Africa/Khartoum">Africa, Khartoum (GMT+03:00)</option> <option value="Africa/Mogadishu">Africa, Mogadishu (GMT+03:00)</option> <option value="Africa/Nairobi">Africa, Nairobi (GMT+03:00)</option> <option value="Antarctica/Syowa">Antarctica, Syowa (GMT+03:00)</option> <option value="Asia/Aden">Asia, Aden (GMT+03:00)</option> <option value="Asia/Amman">Asia, Amman (GMT+03:00)</option> <option value="Asia/Baghdad">Asia, Baghdad (GMT+03:00)</option> <option value="Asia/Bahrain">Asia, Bahrain (GMT+03:00)</option> <option value="Asia/Beirut">Asia, Beirut (GMT+03:00)</option> <option value="Asia/Damascus">Asia, Damascus (GMT+03:00)</option> <option value="Asia/Famagusta">Asia, Famagusta (GMT+03:00)</option> <option value="Asia/Gaza">Asia, Gaza (GMT+03:00)</option> <option value="Asia/Hebron">Asia, Hebron (GMT+03:00)</option> <option value="Asia/Jerusalem">Asia, Jerusalem (GMT+03:00)</option> <option value="Asia/Kuwait">Asia, Kuwait (GMT+03:00)</option> <option value="Asia/Nicosia">Asia, Nicosia (GMT+03:00)</option> <option value="Asia/Qatar">Asia, Qatar (GMT+03:00)</option> <option value="Asia/Riyadh">Asia, Riyadh (GMT+03:00)</option> <option value="Europe/Athens">Europe, Athens (GMT+03:00)</option> <option value="Europe/Bucharest">Europe, Bucharest (GMT+03:00)</option> <option value="Europe/Chisinau">Europe, Chisinau (GMT+03:00)</option> <option value="Europe/Helsinki">Europe, Helsinki (GMT+03:00)</option> <option value="Europe/Istanbul">Europe, Istanbul (GMT+03:00)</option> <option value="Europe/Kiev">Europe, Kiev (GMT+03:00)</option> <option value="Europe/Kirov">Europe, Kirov (GMT+03:00)</option> <option value="Europe/Mariehamn">Europe, Mariehamn (GMT+03:00)</option> <option value="Europe/Minsk">Europe, Minsk (GMT+03:00)</option> <option value="Europe/Moscow">Europe, Moscow (GMT+03:00)</option> <option value="Europe/Riga">Europe, Riga (GMT+03:00)</option> <option value="Europe/Simferopol">Europe, Simferopol (GMT+03:00)</option> <option value="Europe/Sofia">Europe, Sofia (GMT+03:00)</option> <option value="Europe/Tallinn">Europe, Tallinn (GMT+03:00)</option> <option value="Europe/Uzhgorod">Europe, Uzhgorod (GMT+03:00)</option> <option value="Europe/Vilnius">Europe, Vilnius (GMT+03:00)</option> <option value="Europe/Volgograd">Europe, Volgograd (GMT+03:00)</option> <option value="Europe/Zaporozhye">Europe, Zaporozhye (GMT+03:00)</option> <option value="Indian/Antananarivo">Indian, Antananarivo (GMT+03:00)</option> <option value="Indian/Comoro">Indian, Comoro (GMT+03:00)</option> <option value="Indian/Mayotte">Indian, Mayotte (GMT+03:00)</option> <option value="Asia/Baku">Asia, Baku (GMT+04:00)</option> <option value="Asia/Dubai">Asia, Dubai (GMT+04:00)</option> <option value="Asia/Muscat">Asia, Muscat (GMT+04:00)</option> <option value="Asia/Tbilisi">Asia, Tbilisi (GMT+04:00)</option> <option value="Asia/Yerevan">Asia, Yerevan (GMT+04:00)</option> <option value="Europe/Astrakhan">Europe, Astrakhan (GMT+04:00)</option> <option value="Europe/Samara">Europe, Samara (GMT+04:00)</option> <option value="Europe/Saratov">Europe, Saratov (GMT+04:00)</option> <option value="Europe/Ulyanovsk">Europe, Ulyanovsk (GMT+04:00)</option> <option value="Indian/Mahe">Indian, Mahe (GMT+04:00)</option> <option value="Indian/Mauritius">Indian, Mauritius (GMT+04:00)</option> <option value="Indian/Reunion">Indian, Reunion (GMT+04:00)</option> <option value="Asia/Kabul">Asia, Kabul (GMT+04:30)</option> <option value="Asia/Tehran">Asia, Tehran (GMT+04:30)</option> <option value="Antarctica/Mawson">Antarctica, Mawson (GMT+05:00)</option> <option value="Asia/Aqtau">Asia, Aqtau (GMT+05:00)</option> <option value="Asia/Aqtobe">Asia, Aqtobe (GMT+05:00)</option> <option value="Asia/Ashgabat">Asia, Ashgabat (GMT+05:00)</option> <option value="Asia/Atyrau">Asia, Atyrau (GMT+05:00)</option> <option value="Asia/Dushanbe">Asia, Dushanbe (GMT+05:00)</option> <option value="Asia/Karachi">Asia, Karachi (GMT+05:00)</option> <option value="Asia/Oral">Asia, Oral (GMT+05:00)</option> <option value="Asia/Samarkand">Asia, Samarkand (GMT+05:00)</option> <option value="Asia/Tashkent">Asia, Tashkent (GMT+05:00)</option> <option value="Asia/Yekaterinburg">Asia, Yekaterinburg (GMT+05:00)</option> <option value="Indian/Kerguelen">Indian, Kerguelen (GMT+05:00)</option> <option value="Indian/Maldives">Indian, Maldives (GMT+05:00)</option> <option value="Asia/Colombo">Asia, Colombo (GMT+05:30)</option> <option value="Asia/Kolkata">Asia, Kolkata (GMT+05:30)</option> <option value="Asia/Kathmandu">Asia, Kathmandu (GMT+05:45)</option> <option value="Antarctica/Vostok">Antarctica, Vostok (GMT+06:00)</option> <option value="Asia/Almaty">Asia, Almaty (GMT+06:00)</option> <option value="Asia/Bishkek">Asia, Bishkek (GMT+06:00)</option> <option value="Asia/Dhaka">Asia, Dhaka (GMT+06:00)</option> <option value="Asia/Omsk">Asia, Omsk (GMT+06:00)</option> <option value="Asia/Qyzylorda">Asia, Qyzylorda (GMT+06:00)</option> <option value="Asia/Thimphu">Asia, Thimphu (GMT+06:00)</option> <option value="Asia/Urumqi">Asia, Urumqi (GMT+06:00)</option> <option value="Indian/Chagos">Indian, Chagos (GMT+06:00)</option> <option value="Asia/Yangon">Asia, Yangon (GMT+06:30)</option> <option value="Indian/Cocos">Indian, Cocos (GMT+06:30)</option> <option value="Antarctica/Davis">Antarctica, Davis (GMT+07:00)</option> <option value="Asia/Bangkok">Asia, Bangkok (GMT+07:00)</option> <option value="Asia/Barnaul">Asia, Barnaul (GMT+07:00)</option> <option value="Asia/Ho_Chi_Minh">Asia, Ho Chi Minh (GMT+07:00)</option> <option value="Asia/Jakarta">Asia, Jakarta (GMT+07:00)</option> <option value="Asia/Krasnoyarsk">Asia, Krasnoyarsk (GMT+07:00)</option> <option value="Asia/Novokuznetsk">Asia, Novokuznetsk (GMT+07:00)</option> <option value="Asia/Novosibirsk">Asia, Novosibirsk (GMT+07:00)</option> <option value="Asia/Phnom_Penh">Asia, Phnom Penh (GMT+07:00)</option> <option value="Asia/Pontianak">Asia, Pontianak (GMT+07:00)</option> <option value="Asia/Tomsk">Asia, Tomsk (GMT+07:00)</option> <option value="Asia/Vientiane">Asia, Vientiane (GMT+07:00)</option> <option value="Indian/Christmas">Indian, Christmas (GMT+07:00)</option> <option value="Asia/Brunei">Asia, Brunei (GMT+08:00)</option> <option value="Asia/Hong_Kong">Asia, Hong Kong (GMT+08:00)</option> <option value="Asia/Hovd">Asia, Hovd (GMT+08:00)</option> <option value="Asia/Irkutsk">Asia, Irkutsk (GMT+08:00)</option> <option value="Asia/Kuala_Lumpur">Asia, Kuala Lumpur (GMT+08:00)</option> <option value="Asia/Kuching">Asia, Kuching (GMT+08:00)</option> <option value="Asia/Macau">Asia, Macau (GMT+08:00)</option> <option value="Asia/Makassar">Asia, Makassar (GMT+08:00)</option> <option value="Asia/Manila">Asia, Manila (GMT+08:00)</option> <option value="Asia/Shanghai">Asia, Shanghai (GMT+08:00)</option> <option value="Asia/Singapore">Asia, Singapore (GMT+08:00)</option> <option value="Asia/Taipei">Asia, Taipei (GMT+08:00)</option> <option value="Australia/Perth">Australia, Perth (GMT+08:00)</option> <option value="Asia/Pyongyang">Asia, Pyongyang (GMT+08:30)</option> <option value="Australia/Eucla">Australia, Eucla (GMT+08:45)</option> <option value="Asia/Chita">Asia, Chita (GMT+09:00)</option> <option value="Asia/Choibalsan">Asia, Choibalsan (GMT+09:00)</option> <option value="Asia/Dili">Asia, Dili (GMT+09:00)</option> <option value="Asia/Jayapura">Asia, Jayapura (GMT+09:00)</option> <option value="Asia/Khandyga">Asia, Khandyga (GMT+09:00)</option> <option value="Asia/Seoul">Asia, Seoul (GMT+09:00)</option> <option value="Asia/Tokyo">Asia, Tokyo (GMT+09:00)</option> <option value="Asia/Ulaanbaatar">Asia, Ulaanbaatar (GMT+09:00)</option> <option value="Asia/Yakutsk">Asia, Yakutsk (GMT+09:00)</option> <option value="Pacific/Palau">Pacific, Palau (GMT+09:00)</option> <option value="Australia/Adelaide">Australia, Adelaide (GMT+09:30)</option> <option value="Australia/Broken_Hill">Australia, Broken Hill (GMT+09:30)</option> <option value="Australia/Darwin">Australia, Darwin (GMT+09:30)</option> <option value="Antarctica/DumontDUrville">Antarctica, DumontDUrville (GMT+10:00)</option> <option value="Asia/Ust-Nera">Asia, Ust-Nera (GMT+10:00)</option> <option value="Asia/Vladivostok">Asia, Vladivostok (GMT+10:00)</option> <option value="Australia/Brisbane">Australia, Brisbane (GMT+10:00)</option> <option value="Australia/Currie">Australia, Currie (GMT+10:00)</option> <option value="Australia/Hobart">Australia, Hobart (GMT+10:00)</option> <option value="Australia/Lindeman">Australia, Lindeman (GMT+10:00)</option> <option value="Australia/Melbourne">Australia, Melbourne (GMT+10:00)</option> <option value="Australia/Sydney">Australia, Sydney (GMT+10:00)</option> <option value="Pacific/Chuuk">Pacific, Chuuk (GMT+10:00)</option> <option value="Pacific/Guam">Pacific, Guam (GMT+10:00)</option> <option value="Pacific/Port_Moresby">Pacific, Port Moresby (GMT+10:00)</option> <option value="Pacific/Saipan">Pacific, Saipan (GMT+10:00)</option> <option value="Australia/Lord_Howe">Australia, Lord Howe (GMT+10:30)</option> <option value="Antarctica/Casey">Antarctica, Casey (GMT+11:00)</option> <option value="Antarctica/Macquarie">Antarctica, Macquarie (GMT+11:00)</option> <option value="Asia/Magadan">Asia, Magadan (GMT+11:00)</option> <option value="Asia/Sakhalin">Asia, Sakhalin (GMT+11:00)</option> <option value="Asia/Srednekolymsk">Asia, Srednekolymsk (GMT+11:00)</option> <option value="Pacific/Bougainville">Pacific, Bougainville (GMT+11:00)</option> <option value="Pacific/Efate">Pacific, Efate (GMT+11:00)</option> <option value="Pacific/Guadalcanal">Pacific, Guadalcanal (GMT+11:00)</option> <option value="Pacific/Kosrae">Pacific, Kosrae (GMT+11:00)</option> <option value="Pacific/Norfolk">Pacific, Norfolk (GMT+11:00)</option> <option value="Pacific/Noumea">Pacific, Noumea (GMT+11:00)</option> <option value="Pacific/Pohnpei">Pacific, Pohnpei (GMT+11:00)</option> <option value="Antarctica/McMurdo">Antarctica, McMurdo (GMT+12:00)</option> <option value="Asia/Anadyr">Asia, Anadyr (GMT+12:00)</option> <option value="Asia/Kamchatka">Asia, Kamchatka (GMT+12:00)</option> <option value="Pacific/Auckland">Pacific, Auckland (GMT+12:00)</option> <option value="Pacific/Fiji">Pacific, Fiji (GMT+12:00)</option> <option value="Pacific/Funafuti">Pacific, Funafuti (GMT+12:00)</option> <option value="Pacific/Kwajalein">Pacific, Kwajalein (GMT+12:00)</option> <option value="Pacific/Majuro">Pacific, Majuro (GMT+12:00)</option> <option value="Pacific/Nauru">Pacific, Nauru (GMT+12:00)</option> <option value="Pacific/Tarawa">Pacific, Tarawa (GMT+12:00)</option> <option value="Pacific/Wake">Pacific, Wake (GMT+12:00)</option> <option value="Pacific/Wallis">Pacific, Wallis (GMT+12:00)</option> <option value="Pacific/Chatham">Pacific, Chatham (GMT+12:45)</option> <option value="Pacific/Apia">Pacific, Apia (GMT+13:00)</option> <option value="Pacific/Enderbury">Pacific, Enderbury (GMT+13:00)</option> <option value="Pacific/Fakaofo">Pacific, Fakaofo (GMT+13:00)</option> <option value="Pacific/Tongatapu">Pacific, Tongatapu (GMT+13:00)</option> <option value="Pacific/Kiritimati">Pacific, Kiritimati (GMT+14:00)</option>
If you've come up with some other way to get the currently-logged-in user's timezone, you can override this behavior by specifying your own callback function. Just to be safe, you'll probably want to return the app's default timezone (that you configured above), if no user is logged in...
Timezone::setCurrentUsersTimezoneFunction(function() {
if (MyFancyUser()->isLoggedIn())
return MyFancyUser()->getTheirTimezone();
else
return config('app.timezone');
});
Usage
There are two methods which you can use to convert date/times to and from the storage timezone. These are convertToStorage and convertFromStorage. Both of them accept a date/time as the first parameter, which can be essentially any representation of a date, including DateTime, string, timestamp, another Carbon instance, etc. They'll also both return a Carbon instance of the converted date.
Use convertToStorage on a user--supplied date/time before storing it in the database. After retrieving a date/time from the database, use convertFromStorage to convert it to the user's local timezone before displaying it. If you're doing an SPA, consider skipping convertFromStorage entirely, and instead doing the conversion on the client-side using something like Moment.js.
convertToStorage($date = null, $fromTimezone = null)
Converts a date from the user's timezone into a Carbon date adjusted for the storage timezone.
@param Carbon|DateTime|string|int $date The date to convert (or now, if not specified). Can be a Carbon, DateTime, string, timestamp, etc.
@param string $fromTimezone If specified, the date will be converted from this timezone. Otherwise, the current user's timezone is assumed.
@return Carbon The converted date
//Example...
$carbonDate = Timezone::convertToStorage('2017-12-10 12:10:00');
convertFromStorage($date = null, $toTimezone = null)
Converts a date from storage into a Carbon date adjusted to the user's timezone.
@param Carbon|DateTime|string|int $date The date to convert (or now, if not specified). Can be a Carbon, DateTime, string, timestamp, etc.
@param string $toTimezone If specified, the date will be converted to this timezone. Otherwise, the current user's timezone is assumed.
@return Carbon The converted date
//Example...
$carbonDate = Timezone::convertFromStorage('2017-12-10 12:10:00');
Credits
Inspired by camroncade/timezone
gazugafan/laravel-timezone 适用场景与选型建议
gazugafan/laravel-timezone 是一款 基于 PHP 开发的 Composer 扩展包，目前已累计 1.45k 次下载、GitHub Stars 达 6， 最近一次更新时间为 2017 年 05 月 07 日， 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向： 「laravel」 「timezone」 「timezones」 等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 gazugafan/laravel-timezone 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。
围绕 gazugafan/laravel-timezone 我们能提供哪些服务？
定制开发 / 二次开发
基于 gazugafan/laravel-timezone 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
BUG 修复 & 性能优化
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。
项目外包 & 长期维护
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。
yvsm@zunyunkeji.com
QQ：316430983
微信：yvsm316
西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发
与 gazugafan/laravel-timezone 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：
fewagency/carbonator
3
Datetime helpers for timezone handling
avoran/doctrine-dbal-datetime-default-tz
0
A custom Doctine DBAL type to use PHP DateTime objects set to the system's default timezone.
rekamy/timezone
0
Timezone List Plugin
ipgeolocation/ipgeolocation-php-sdk
41
Official PHP SDK for the IPGeolocation.io IP Location API with single and bulk lookup support.
upmind/pragmarx-countries
0
PHP Countries and Currencies
sierratecnologia/muleta
0
SierraTecnologia common support helpers, contracts, and traits required by various SierraTecnologia packages. Validator functionality, and basic controller included out-of-the-box.
统计信息
- 总下载量： 1.45k
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 6
- 点击次数： 9
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2017-05-07