Flutter-docs/Flutter/calendar/timezone.md

1221 строка
14 KiB
Markdown
Исходник Постоянная ссылка Обычный вид История

---
layout: post
2021-07-09 17:50:21 +03:00
title: Time zone in Flutter Event Calendar widget | Syncfusion
2021-04-26 12:10:12 +03:00
description: Learn here all about Time zone feature of Syncfusion Flutter Event Calendar (SfCalendar) widget and more.
platform: flutter
control: SfCalendar
documentation: ug
---
2021-04-26 12:10:12 +03:00
# Time zone in Flutter Event Calendar (SfCalendar)
2021-09-29 03:55:24 +03:00
[Flutter Calendar](https://www.syncfusion.com/flutter-widgets/flutter-calendar) allows you to create appointments in various time zones and display them in users time zone or any other time zone. You can use a time zone in the following four different ways:
* Create appointments in different time zones.
* Display appointments based on the clients time zone.
* Display appointments based on calendar time zone.
* Display appointments at the same time everywhere regardless of clients time zone.
We have added the following Time Zones for the respective countries to cover all the time zone regions, you can use any of the time zones from the following list for calendar time zone.
<table>
<tr>
<th>Time Zone</th>
<th>Region</th>
<th>UTC Offset</th>
</tr>
<tr>
<td>
Samoa Standard Time
</td>
<td>
Pacific/Apia
</td>
<td>
UTC - 13:00
</td>
</tr>
<tr>
<td>
Dateline Standard Time
</td>
<td>
Etc/GMT+12
</td>
<td>
UTC - 12:00
</td>
</tr>
<tr>
<td>
UTC-11
</td>
<td>
Pacific/Midway
</td>
<td>
UTC - 11:00
</td>
</tr>
<tr>
<td>
Hawaiian Standard Time
</td>
<td>
Pacific/Honolulu
</td>
<td>
UTC - 10:00
</td>
</tr>
<tr>
<td>
Alaskan Standard Time
</td>
<td>
America/Anchorage
</td>
<td>
UTC - 09:00
</td>
</tr>
<tr>
<td>
Pacific Standard Time
</td>
<td>
America/Los_Angeles
</td>
<td>
UTC - 08:00
</td>
</tr>
<tr>
<td>
Pacific Standard Time (Mexico)
</td>
<td>
America/Santa_Isabel
</td>
<td>
UTC - 08:00
</td>
</tr>
<tr>
<td>
Mountain Standard Time
</td>
<td>
America/Denver
</td>
<td>
UTC - 07:00
</td>
</tr>
<tr>
<td>
Mountain Standard Time (Mexico)
</td>
<td>
America/Chihuahua
</td>
<td>
UTC - 07:00
</td>
</tr>
<tr>
<td>
US Mountain Standard Time
</td>
<td>
America/Phoenix
</td>
<td>
UTC - 07:00
</td>
</tr>
<tr>
<td>
Canada Central Standard Time
</td>
<td>
America/Regina
</td>
<td>
UTC - 06:00
</td>
</tr>
<tr>
<td>
Central America Standard Time
</td>
<td>
America/Guatemala
</td>
<td>
UTC - 06:00
</td>
</tr>
<tr>
<td>
Central Standard Time
</td>
<td>
America/Chicago
</td>
<td>
UTC - 06:00
</td>
</tr>
<tr>
<td>
Eastern Standard Time
</td>
<td>
America/New_York
</td>
<td>
UTC - 05:00
</td>
</tr>
<tr>
<td>
SA Pacific Standard Time
</td>
<td>
America/Bogota
</td>
<td>
UTC - 05:00
</td>
</tr>
<tr>
<td>
US Eastern Standard Time
</td>
<td>
America/Indianapolis
</td>
<td>
UTC - 05:00
</td>
</tr>
<tr>
<td>
Venezuela Standard Time
</td>
<td>
America/Caracas
</td>
<td>
UTC - 04:30
</td>
</tr>
<tr>
<td>
Atlantic Standard Time
</td>
<td>
America/Halifax
</td>
<td>
UTC - 04:00
</td>
</tr>
<tr>
<td>
Central Brazilian Standard Time
</td>
<td>
America/Cuiaba
</td>
<td>
UTC - 04:00
</td>
</tr>
<tr>
<td>
Pacific SA Standard Time
</td>
<td>
America/Santiago
</td>
<td>
UTC - 04:00
</td>
</tr>
<tr>
<td>
Paraguay Standard Time
</td>
<td>
America/Asuncion
</td>
<td>
UTC - 04:00
</td>
</tr>
<tr>
<td>
SA Western Standard Time
</td>
<td>
America/La_Paz
</td>
<td>
UTC - 04:00
</td>
</tr>
<tr>
<td>
Newfoundland Standard Time
</td>
<td>
America/St_Johns
</td>
<td>
UTC - 03:30
</td>
</tr>
<tr>
<td>
Bahia Standard Time
</td>
<td>
America/Bahia
</td>
<td>
UTC - 03:00
</td>
</tr>
<tr>
<td>
Argentina Standard Time
</td>
<td>
America/Buenos_Aires
</td>
<td>
UTC - 03:00
</td>
</tr>
<tr>
<td>
E. South America Standard Time
</td>
<td>
America/Sao_Paulo
</td>
<td>
UTC - 03:00
</td>
</tr>
<tr>
<td>
Greenland Standard Time
</td>
<td>
America/Godthab
</td>
<td>
UTC - 03:00
</td>
</tr>
<tr>
<td>
Montevideo Standard Time
</td>
<td>
America/Montevideo
</td>
<td>
UTC - 03:00
</td>
</tr>
<tr>
<td>
SA Eastern Standard Time
</td>
<td>
America/Cayenne
</td>
<td>
UTC - 03:00
</td>
</tr>
<tr>
<td>
UTC-02
</td>
<td>
America/Noronha
</td>
<td>
UTC - 02:00
</td>
</tr>
<tr>
<td>
Azores Standard Time
</td>
<td>
Atlantic/Azores
</td>
<td>
UTC - 01:00
</td>
</tr>
<tr>
<td>
Cape Verde Standard Time
</td>
<td>
Atlantic/Cape_Verde
</td>
<td>
UTC - 01:00
</td>
</tr>
<tr>
<td>
GMT Standard Time
</td>
<td>
Europe/London
</td>
<td>
UTC
</td>
</tr>
<tr>
<td>
Greenwich Standard Time
</td>
<td>
Atlantic/Reykjavik
</td>
<td>
UTC
</td>
</tr>
<tr>
<td>
Morocco Standard Time
</td>
<td>
Africa/Casablanca
</td>
<td>
UTC
</td>
</tr>
<tr>
<td>
UTC
</td>
<td>
America/Danmarkshavn
</td>
<td>
UTC
</td>
</tr>
<tr>
<td>
Central Europe Standard Time
</td>
<td>
Europe/Budapest
</td>
<td>
UTC + 01:00
</td>
</tr>
<tr>
<td>
Central European Standard Time
</td>
<td>
Europe/Warsaw
</td>
<td>
UTC + 01:00
</td>
</tr>
<tr>
<td>
Namibia Standard Time
</td>
<td>
Africa/Windhoek
</td>
<td>
UTC + 01:00
</td>
</tr>
<tr>
<td>
Romance Standard Time
</td>
<td>
Europe/Paris
</td>
<td>
UTC + 01:00
</td>
</tr>
<tr>
<td>
W. Central Africa Standard Time
</td>
<td>
Africa/Lagos
</td>
<td>
UTC + 01:00
</td>
</tr>
<tr>
<td>
W. Europe Standard Time
</td>
<td>
Europe/Berlin
</td>
<td>
UTC + 01:00
</td>
</tr>
<tr>
<tr>
<td>
Egypt Standard Time
</td>
<td>
Africa/Cairo
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
FLE Standard Time
</td>
<td>
Europe/Kiev
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
GTB Standard Time
</td>
<td>
Europe/Bucharest
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
Israel Standard Time
</td>
<td>
Asia/Jerusalem
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
Libya Standard Time
</td>
<td>
Africa/Tripoli
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
Middle East Standard Time
</td>
<td>
Asia/Beirut
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
South Africa Standard Time
</td>
<td>
Africa/Johannesburg
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
Syria Standard Time
</td>
<td>
Asia/Damascus
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
Turkey Standard Time
</td>
<td>
Europe/Istanbul
</td>
<td>
UTC + 02:00
</td>
</tr>
<tr>
<td>
Arab Standard Time
</td>
<td>
Asia/Riyadh
</td>
<td>
UTC + 03:00
</td>
</tr>
<tr>
<td>
Arabic Standard Time
</td>
<td>
Asia/Baghdad
</td>
<td>
UTC + 03:00
</td>
</tr>
<tr>
<td>
Belarus Standard Time
</td>
<td>
Europe/Minsk
</td>
<td>
UTC + 03:00
</td>
</tr>
<tr>
<td>
E. Africa Standard Time
</td>
<td>
Africa/Nairobi
</td>
<td>
UTC + 03:00
</td>
</tr>
<tr>
<td>
Jordan Standard Time
</td>
<td>
Asia/Amman
</td>
<td>
UTC + 03:00
</td>
</tr>
<tr>
<td>
Kaliningrad Standard Time
</td>
<td>
Europe/Kaliningrad
</td>
<td>
UTC + 03:00
</td>
</tr>
<tr>
<td>
Iran Standard Time
</td>
<td>
Asia/Tehran
</td>
<td>
UTC + 03:30
</td>
</tr>
<tr>
<td>
Arabian Standard Time
</td>
<td>
Etc/GMT-4
</td>
<td>
UTC + 04:00
</td>
</tr>
<tr>
<td>
Azerbaijan Standard Time
</td>
<td>
Asia/Baku
</td>
<td>
UTC + 04:00
</td>
</tr>
<tr>
<td>
Caucasus Standard Time
</td>
<td>
Asia/Yerevan
</td>
<td>
UTC + 04:00
</td>
</tr>
<tr>
<td>
Georgian Standard Time
</td>
<td>
Asia/Tbilisi
</td>
<td>
UTC + 04:00
</td>
</tr>
<tr>
<td>
Mauritius Standard Time
</td>
<td>
Indian/Mauritius
</td>
<td>
UTC + 04:00
</td>
</tr>
<tr>
<td>
Russia Time Zone 3
</td>
<td>
Europe/Samara
</td>
<td>
UTC + 04:00
</td>
</tr>
<tr>
<td>
Russian Standard Time
</td>
<td>
Europe/Moscow
</td>
<td>
UTC + 04:00
</td>
</tr>
<tr>
<td>
Afghanistan Standard Time
</td>
<td>
Asia/Kabul
</td>
<td>
UTC + 04:30
</td>
</tr>
<tr>
<td>
Pakistan Standard Time
</td>
<td>
Asia/Karachi
</td>
<td>
UTC + 05:00
</td>
</tr>
<td>
West Asia Standard Time
</td>
<td>
Asia/Tashkent
</td>
<td>
UTC + 05:00
</td>
</tr>
<tr>
<td>
India Standard Time
</td>
<td>
Asia/Calcutta
</td>
<td>
UTC + 05:30
</td>
</tr>
<tr>
<td>
Sri Lanka Standard Time
</td>
<td>
Asia/Colombo
</td>
<td>
UTC + 05:30
</td>
</tr>
<tr>
<td>
Nepal Standard Time
</td>
<td>
Asia/Kathmandu
</td>
<td>
UTC + 05:45
</td>
</tr>
<tr>
<td>
Bangladesh Standard Time
</td>
<td>
Asia/Dhaka
</td>
<td>
UTC + 06:00
</td>
</tr>
<tr>
<td>
Central Asia Standard Time
</td>
<td>
Asia/Almaty
</td>
<td>
UTC + 06:00
</td>
</tr>
<tr>
<td>
Ekaterinburg Standard Time
</td>
<td>
Asia/Yekaterinburg
</td>
<td>
UTC + 06:00
</td>
</tr>
<tr>
<td>
Myanmar Standard Time
</td>
<td>
Asia/Rangoon
</td>
<td>
UTC + 06:30
</td>
</tr>
<tr>
<td>
SE Asia Standard Time
</td>
<td>
Asia/Bangkok
</td>
<td>
UTC + 07:00
</td>
</tr>
<tr>
<td>
N. Central Asia Standard Time
</td>
<td>
Asia/Novosibirsk
</td>
<td>
UTC + 07:00
</td>
</tr>
<tr>
<td>
China Standard Time
</td>
<td>
Asia/Shanghai
</td>
<td>
UTC + 08:00
</td>
</tr>
<tr>
<td>
North Asia Standard Time
</td>
<td>
Asia/Krasnoyarsk
</td>
<td>
UTC + 08:00
</td>
</tr>
<tr>
<td>
Singapore Standard Time
</td>
<td>
Asia/Singapore
</td>
<td>
UTC + 08:00
</td>
</tr>
<tr>
<td>
Taipei Standard Time
</td>
<td>
Asia/Taipei
</td>
<td>
UTC + 08:00
</td>
</tr>
<tr>
<td>
Ulaanbaatar Standard Time
</td>
<td>
Asia/Ulaanbaatar
</td>
<td>
UTC + 08:00
</td>
</tr>
<tr>
<td>
W. Australia Standard Time
</td>
<td>
Australia/Perth
</td>
<td>
UTC + 08:00
</td>
</tr>
<tr>
<td>
Korea Standard Time
</td>
<td>
Asia/Seoul
</td>
<td>
UTC + 09:00
</td>
</tr>
<tr>
<td>
North Asia East Standard Time
</td>
<td>
Asia/Irkutsk
</td>
<td>
UTC + 09:00
</td>
</tr>
<tr>
<td>
Tokyo Standard Time
</td>
<td>
Asia/Tokyo
</td>
<td>
UTC + 09:00
</td>
</tr>
<tr>
<td>
AUS Central Standard Time
</td>
<td>
Australia/Darwin
</td>
<td>
UTC + 09:30
</td>
</tr>
<tr>
<td>
Cen. Australia Standard Time
</td>
<td>
Australia/Adelaide
</td>
<td>
UTC + 09:30
</td>
</tr>
<tr>
<td>
AUS Eastern Standard Time
</td>
<td>
Australia/Sydney
</td>
<td>
UTC + 10:00
</td>
</tr>
<tr>
<td>
E. Australia Standard Time
</td>
<td>
Australia/Brisbane
</td>
<td>
UTC + 10:00
</td>
</tr>
<tr>
<td>
Tasmania Standard Time
</td>
<td>
Australia/Hobart
</td>
<td>
UTC + 10:00
</td>
</tr>
<tr>
<td>
West Pacific Standard Time
</td>
<td>
Pacific/Port Moresby
</td>
<td>
UTC + 10:00
</td>
</tr>
<tr>
<td>
Yakutsk Standard Time
</td>
<td>
Asia/Yakutsk
</td>
<td>
UTC + 10:00
</td>
</tr>
<tr>
<td>
Central Pacific Standard Time
</td>
<td>
Pacific/Guadalcanal
</td>
<td>
UTC + 11:00
</td>
</tr>
<tr>
<td>
Russia Time Zone 10
</td>
<td>
Asia/Srednekolymsk
</td>
<td>
UTC + 11:00
</td>
</tr>
<tr>
<td>
Vladivostok Standard Time
</td>
<td>
Asia/Vladivostok
</td>
<td>
UTC + 11:00
</td>
</tr>
<tr>
<td>
Fiji Standard Time
</td>
<td>
Pacific/Fiji
</td>
<td>
UTC + 12:00
</td>
</tr>
<tr>
<td>
Magadan Standard Time
</td>
<td>
Asia/Magadan
</td>
<td>
UTC + 12:00
</td>
</tr>
<tr>
<td>
New Zealand Standard Time
</td>
<td>
Pacific/Auckland
</td>
<td>
UTC + 12:00
</td>
</tr>
<tr>
<td>
Russia Time Zone 11
</td>
<td>
Asia/Kamchatka
</td>
<td>
UTC + 12:00
</td>
</tr>
<tr>
<td>
UTC+12
</td>
<td>
Pacific/Tarawa
</td>
<td>
UTC + 12:00
</td>
</tr>
<tr>
<td>
Tonga Standard Time
</td>
<td>
Pacific/Tongatapu
</td>
<td>
UTC + 13:00
</td>
</tr>
<tr>
<td>
Line Islands Standard Time
</td>
<td>
Pacific/Kiritimati
</td>
<td>
UTC + 14:00
</td>
</tr>
</table>
## Create appointment in different time zones
You can create appointments at different time zones using the [startTimeZone](https://pub.dev/documentation/syncfusion_flutter_calendar/latest/calendar/Appointment/startTimeZone.html) and [endTimeZone](https://pub.dev/documentation/syncfusion_flutter_calendar/latest/calendar/Appointment/endTimeZone.html) properties of `Appointment`. An appointments start time and end time are calculated based on the given time zone information for the start time and end time. You can set different time zones to the `startTimeZone` and `endTimeZone` properties.
You can use the `startTime` and `endTime` properties of `Appointment` to get the exact start time and end time of an appointment.
{% tabs %}
{% highlight Dart %}
List<Appointment> appointments = <Appointment>[];
appointments.add(Appointment(
startTime: DateTime(2019, 12, 16, 10),
endTime: DateTime(2019, 12, 16, 12),
subject: 'Meeting',
startTimeZone: 'India Standard Time',
endTimeZone: 'India Standard Time',
color: Colors.blue));
{% endhighlight %}
{% endtabs %}
>**NOTE**
* If the recurring appointment is converted to another time zone, then the whole sequence will be recalculated according to the new time zone information.
* If you create an all-day appointment, its start time and end time will be set to 12 A.M. and 12 A.M. by default, so time zone is not applicable for all-day appointments.
* Calendar supports daylight saving time.
* The time zone support is applicable for custom appointments too, so you need to map the corresponding property.
* You can use TimeZone for custom appointments by mapping the `startTimeZoneMapper` and `endTimeZoneMapper` custom properties of `CalendarDataSource`.
## Display appointment based on clients time zone
You can display the appointments based on the clients local time zone in calendar. For example, consider a scenario that you are in North Carolina and you want to set up a meeting at 10 A.M. on North Carolina time. You have colleagues in London and Chennai, and they also need to participate. The time for this meeting will be 3 P.M. (15:00) in London and 5.30 A.M. in Chennai. When you each view your calendar, you need to see the appointment displayed relative to your local time zones 5.30 A.M., 10 A.M., and 3 P.M., respectively. It can be achieved by setting calendar time zone to default (it will consider your devices local time zone as calendar time zone) and appointments time zone to Eastern Standard Time (North Carolina) [as you are in North Carolina and its time zone is Eastern Standard Time].
## Display appointments based on calendar time zone
You can set specific time zone to calendar using the [timeZone](https://pub.dev/documentation/syncfusion_flutter_calendar/latest/calendar/SfCalendar/timeZone.html) property of calendar. On this scenario, the appointments will be displayed in UTC time when the `startTimeZone` and `endTimeZone` properties of `Appointment` are set to null. The appointments will be displayed in UTC time based on the given calendar time zone.
{% tabs %}
{% highlight Dart %}
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
body: Container(
child: SfCalendar(
view: CalendarView.week,
timeZone: 'Central America Standard Time',
),
),
),
);
}
{% endhighlight %}
{% endtabs %}
## Display appointments at same time everywhere regardless of clients time zone
You can display appointments at the same time everywhere without considering the time zone when you set the `timeZone` property of calendar, the `startTimeZone` and `endTimeZone` properties of `Appointment` to null. The appointments will be displayed based on the given `startTime` and `endTime` of appointment everywhere without considering the time zone.