ComponentOne True DBInput Pro 8.0
WorldTimeCalc Method (TDBTZoneX)

 

Reference> TDBTZoneX Object> TDBTZoneX Object Methods> WorldTimeCalc Method (TDBTZoneX)

WorldTimeCalc Method (TDBTZoneX)

Returns a date and time value of the destination time zone. The WorldTimeCalc method allows you to figure the time value for the destination time zone when calculating between two cities within Time Zones. If the DSTStyles property is applied to srcDSTS and destDSTS, the calculation results will be adjusted accordingly. If not, the Standard Time will be applied.

Syntax

object.WorldTimeCalc (Time, srcCity, [srcDSTS], destCity, [destDSTS])

Arguments

Time is a required variant (Date): the date/time value for the source city.

srcCity is a required constant that specifies the source city.

srcDSTS is an optional variant (DSTStyle object): a DSTStyle object that controls the Daylight Savings Time adjustments for the source city within a Time Zone. If not specified, the Standard Time will be applied.

destCity is a required constant that specifies the destination city.

destDSTS is an optional variant (DSTStyle object): a DSTStyle object that controls the Daylight Savings Time adjustments for the destination city within a Time Zone. If not specified, the Standard Time will be applied

srcCity and destCity arguments have these settings:

1 - (GMT-12:00) Eniwetok, Kwajalein

2 - (GMT-11:00) Midway Island, Samoa

3 - (GMT-10:00) Hawaii

4 - (GMT-09:00) Alaska

5 - (GMT-08:00) Pacific Time (US & Canada); Tijuana

6 - (GMT-07:00) Arizona

7 - (GMT-07:00) Mountain Time (US & Canada)

8 - (GMT-06:00) Central Time (US & Canada)

9 - (GMT-06:00) Mexico City, Tegucigalpa

10 - (GMT-06:00) Saskatchewan

11 - (GMT-05:00) Bogota, Lima

12 - (GMT-05:00) Eastern Time (US & Canada)

13 - (GMT-05:00) Indiana (East)

14 - (GMT-04:00) Atlantic Time (Canada)

15 - (GMT-04:00) Caracas, La Paz

16 - (GMT-03:30) Newfoundland

17 - (GMT-03:00) Brasilia

18 - (GMT-03:00) Buenos Aires, Georgetown

19 - (GMT-02:00) Mid-Atlantic

20 - (GMT-01:00) Azores, Cape Verde Is.

21 - (GMT) Greenwich Mean Time; Dublin, Edinburgh, London Lisbon

22 - (GMT) Monrovia, Casablanca

23 - (GMT+01:00) Berlin, Stockholm, Bern, Brussels, Vienna

24 - (GMT+01:00) Paris, Madrid, Amsterdam

25 - (GMT+01:00) Prague, Budapest

26 - (GMT+01:00) Warsaw

27 - (GMT+02:00) Athens, Helsinki, Istanbul

28 - (GMT+02:00) Cairo

29 - (GMT+02:00) Eastern Europe

30 - (GMT+02:00) Harare, Pretoria

31 - (GMT+02:00) Israel

32 - (GMT+03:00) Baghdad, Kuwait, Nairobi, Riyadh

33 - (GMT+03:00) Moscow, St. Petersburg, Kazan, Volgograd

34 - (GMT+03:30) Tehran

35 - (GMT+04:00) Abu Dhabi, Muscat, Tbilisi

36 - (GMT+04:30) Kabul

37 - (GMT+05:00) Islamabad, Karachi, Ekaterinburg, Tashkent

38 - (GMT+05:00) Bombay, Calcutta, Madras, New Delhi, Colombo

39 - (GMT+06:00) Almaty, Dhaka

40 - (GMT+07:00) Bangkok, Jakarta, Hanoi

41 - (GMT+08:00) Beijing, Chongqing, Urumqi

42 - (GMT+08:00) Hong Kong, Perth, Singapore, Taipei

43 - (GMT+09:00) Tokyo, Osaka, Sapporo, Seoul, Yakutsk

44 - (GMT+09:30) Adelaide

45 - (GMT+09:30) Darwin

46 - (GMT+10:00) Brisbane, Melbourne

47 - (GMT+10:00) Sydney

48 - (GMT+10:00) Guam, Port Moresby, Vladivostok

49 - (GMT+10:00) Hobart

50 - (GMT+11:00) Magadan, Solomon Is., New Caledonia

51 - (GMT+12:00) Fiji, Kamchatka, Marshall Is.

52 - (GMT+12:00) Wellington, Auckland

Return Value

The date/time value for the destination city. If Time is set to Null or the calculation result exceeds the range from 100/01/01-9999/12/31, this method returns Null.

Remarks

If the year part for Time is omitted, WorldTimeCalc uses the current year from your system date.

If Time only includes date information, time will be automatically treated as 12:00:00 AM. However, if only time information is included, date will be treated as 0, which equals December 30, 1899.

See Also

Understanding Time Zones

Understanding Daylight Savings Time

WorldTimeDiff Method (TDBTZoneX)

 

 


Copyright (c) GrapeCity, inc. All rights reserved.

Product Support Forum  |  Documentation Feedback