# vutime

Time Based Utility Tools for Python

## Installation

```bash
pip install vutime
```

## Usage

### Adding Times

```python
from vutime import add_time

# Add two times in HH:MM:SS format
result = add_time("10:30:43", "07:53:49")
print(result)  # Output: 18:24:32

# Add times with different formats
result = add_time("10:30", "05:45", time_format_1="HH:MM", time_format_2="HH:MM", return_format="HH:MM:SS")
print(result)  # Output: 16:15:00
```

### Subtracting Times

```python
from vutime import subtract_time

# Subtract two times (time1 must be greater than time2)
result = subtract_time("10:30:43", "07:53:49")
print(result)  # Output: 02:36:54

# Subtract times with custom formats
result = subtract_time("10:30", "05:45", time_format_1="HH:MM", time_format_2="HH:MM")
print(result)  # Output: 04:45:00
```

### Getting Timezone Information

```python
from vutime.conversions.timezones import get_timezone

# Get timezone information for a specific identifier
tz_info = get_timezone("Asia/Tokyo")
print(tz_info)
# Output: {'identifier': 'Asia/Tokyo', 'sign': '+', 'offset': '09:00'}
```

### Converting Time Between Timezones

```python
from vutime.conversions.timezones import convert_time_tz

# Convert time from one timezone to another
result = convert_time_tz("12:00:00", "America/New_York", "Asia/Tokyo")
print(result)  # Output: 02:00:00 (next day)

# Convert with custom time formats
result = convert_time_tz("14:30", "Europe/London", "America/Los_Angeles", 
                        time_format="HH:MM", return_format="HH:MM")
print(result)  # Output: 06:30
```

## Format Options

Supported time formats:
- `HH:MM:SS` - Hours, minutes, seconds (default)
- `HH:MM` - Hours, minutes
- `MM:SS` - Minutes, seconds

## Supported Timezone Identifiers

The following is a complete list of all supported timezone identifiers (563 total):

| Africa/Abidjan                     | Africa/Accra                       | Africa/Addis_Ababa                 |
| Africa/Algiers                     | Africa/Asmara                      | Africa/Asmera                      |
| Africa/Bamako                      | Africa/Bangui                      | Africa/Banjul                      |
| Africa/Bissau                      | Africa/Blantyre                    | Africa/Brazzaville                 |
| Africa/Bujumbura                   | Africa/Cairo                       | Africa/Casablanca                  |
| Africa/Ceuta                       | Africa/Conakry                     | Africa/Dakar                       |
| Africa/Dar_es_Salaam               | Africa/Djibouti                    | Africa/Douala                      |
| Africa/El_Aaiun                    | Africa/Freetown                    | Africa/Gaborone                    |
| Africa/Harare                      | Africa/Johannesburg                | Africa/Juba                        |
| Africa/Kampala                     | Africa/Khartoum                    | Africa/Kigali                      |
| Africa/Kinshasa                    | Africa/Lagos                       | Africa/Libreville                  |
| Africa/Lome                        | Africa/Luanda                      | Africa/Lubumbashi                  |
| Africa/Lusaka                      | Africa/Malabo                      | Africa/Maputo                      |
| Africa/Maseru                      | Africa/Mbabane                     | Africa/Mogadishu                   |
| Africa/Monrovia                    | Africa/Nairobi                     | Africa/Ndjamena                    |
| Africa/Niamey                      | Africa/Nouakchott                  | Africa/Ouagadougou                 |
| Africa/Porto-Novo                  | Africa/Sao_Tome                    | Africa/Timbuktu                    |
| Africa/Tripoli                     | Africa/Tunis                       | Africa/Windhoek                    |
| America/Adak                       | America/Anchorage                  | America/Anguilla                   |
| America/Antigua                    | America/Araguaina                  | America/Argentina/Buenos_Aires     |
| America/Argentina/Catamarca        | America/Argentina/ComodRivadavia   | America/Argentina/Cordoba          |
| America/Argentina/Jujuy            | America/Argentina/La_Rioja         | America/Argentina/Mendoza          |
| America/Argentina/Rio_Gallegos     | America/Argentina/Salta            | America/Argentina/San_Juan         |
| America/Argentina/San_Luis         | America/Argentina/Tucuman          | America/Argentina/Ushuaia          |
| America/Aruba                      | America/Asuncion                   | America/Atikokan                   |
| America/Atka                       | America/Bahia                      | America/Bahia_Banderas             |
| America/Barbados                   | America/Belem                      | America/Belize                     |
| America/Blanc-Sablon               | America/Boa_Vista                  | America/Bogota                     |
| America/Boise                      | America/Buenos_Aires               | America/Cambridge_Bay              |
| America/Campo_Grande               | America/Cancun                     | America/Caracas                    |
| America/Catamarca                  | America/Cayenne                    | America/Cayman                     |
| America/Chicago                    | America/Chihuahua                  | America/Ciudad_Juarez              |
| America/Coral_Harbour              | America/Cordoba                    | America/Costa_Rica                 |
| America/Coyhaique                  | America/Creston                    | America/Cuiaba                     |
| America/Curacao                    | America/Danmarkshavn               | America/Dawson                     |
| America/Dawson_Creek               | America/Denver                     | America/Detroit                    |
| America/Dominica                   | America/Edmonton                   | America/Eirunepe                   |
| America/El_Salvador                | America/Ensenada                   | America/Fort_Nelson                |
| America/Fort_Wayne                 | America/Fortaleza                  | America/Glace_Bay                  |
| America/Godthab                    | America/Goose_Bay                  | America/Grand_Turk                 |
| America/Grenada                    | America/Guadeloupe                 | America/Guatemala                  |
| America/Guayaquil                  | America/Guyana                     | America/Halifax                    |
| America/Havana                     | America/Hermosillo                 | America/Indiana/Indianapolis       |
| America/Indiana/Knox               | America/Indiana/Marengo            | America/Indiana/Petersburg         |
| America/Indiana/Tell_City          | America/Indiana/Vevay              | America/Indiana/Vincennes          |
| America/Indiana/Winamac            | America/Indianapolis               | America/Inuvik                     |
| America/Iqaluit                    | America/Jamaica                    | America/Jujuy                      |
| America/Juneau                     | America/Kentucky/Louisville        | America/Kentucky/Monticello        |
| America/Knox_IN                    | America/Kralendijk                 | America/La_Paz                     |
| America/Lima                       | America/Los_Angeles                | America/Louisville                 |
| America/Lower_Princes              | America/Maceio                     | America/Managua                    |
| America/Manaus                     | America/Marigot                    | America/Martinique                 |
| America/Matamoros                  | America/Mazatlan                   | America/Mendoza                    |
| America/Menominee                  | America/Merida                     | America/Metlakatla                 |
| America/Mexico_City                | America/Miquelon                   | America/Moncton                    |
| America/Monterrey                  | America/Montevideo                 | America/Montreal                   |
| America/Montserrat                 | America/Nassau                     | America/New_York                   |
| America/Nipigon                    | America/Nome                       | America/Noronha                    |
| America/North_Dakota/Beulah        | America/North_Dakota/Center        | America/North_Dakota/New_Salem     |
| America/Nuuk                       | America/Ojinaga                    | America/Panama                     |
| America/Pangnirtung                | America/Paramaribo                 | America/Phoenix                    |
| America/Port-au-Prince             | America/Port_of_Spain              | America/Porto_Acre                 |
| America/Porto_Velho                | America/Puerto_Rico                | America/Punta_Arenas               |
| America/Rainy_River                | America/Rankin_Inlet               | America/Recife                     |
| America/Regina                     | America/Resolute                   | America/Rio_Branco                 |
| America/Rosario                    | America/Santa_Isabel               | America/Santarem                   |
| America/Santiago                   | America/Santo_Domingo              | America/Sao_Paulo                  |
| America/Scoresbysund               | America/Shiprock                   | America/Sitka                      |
| America/St_Barthelemy              | America/St_Johns                   | America/St_Kitts                   |
| America/St_Lucia                   | America/St_Thomas                  | America/St_Vincent                 |
| America/Swift_Current              | America/Tegucigalpa                | America/Thule                      |
| America/Thunder_Bay                | America/Tijuana                    | America/Toronto                    |
| America/Tortola                    | America/Vancouver                  | America/Virgin                     |
| America/Whitehorse                 | America/Winnipeg                   | America/Yakutat                    |
| America/Yellowknife                | Antarctica/Casey                   | Antarctica/Davis                   |
| Antarctica/DumontDUrville          | Antarctica/Macquarie               | Antarctica/Mawson                  |
| Antarctica/McMurdo                 | Antarctica/Palmer                  | Antarctica/Rothera                 |
| Antarctica/South_Pole              | Antarctica/Syowa                   | Antarctica/Troll                   |
| Antarctica/Vostok                  | Arctic/Longyearbyen                | Asia/Aden                          |
| Asia/Almaty                        | Asia/Amman                         | Asia/Anadyr                        |
| Asia/Aqtau                         | Asia/Aqtobe                        | Asia/Ashgabat                      |
| Asia/Ashkhabad                     | Asia/Atyrau                        | Asia/Baghdad                       |
| Asia/Bahrain                       | Asia/Baku                          | Asia/Bangkok                       |
| Asia/Barnaul                       | Asia/Beirut                        | Asia/Bishkek                       |
| Asia/Brunei                        | Asia/Calcutta                      | Asia/Chita                         |
| Asia/Choibalsan                    | Asia/Chongqing                     | Asia/Chungking                     |
| Asia/Colombo                       | Asia/Dacca                         | Asia/Damascus                      |
| Asia/Dhaka                         | Asia/Dili                          | Asia/Dubai                         |
| Asia/Dushanbe                      | Asia/Famagusta                     | Asia/Gaza                          |
| Asia/Harbin                        | Asia/Hebron                        | Asia/Ho_Chi_Minh                   |
| Asia/Hong_Kong                     | Asia/Hovd                          | Asia/Irkutsk                       |
| Asia/Istanbul                      | Asia/Jakarta                       | Asia/Jayapura                      |
| Asia/Jerusalem                     | Asia/Kabul                         | Asia/Kamchatka                     |
| Asia/Karachi                       | Asia/Kashgar                       | Asia/Kathmandu                     |
| Asia/Katmandu                      | Asia/Khandyga                      | Asia/Kolkata                       |
| Asia/Krasnoyarsk                   | Asia/Kuala_Lumpur                  | Asia/Kuching                       |
| Asia/Kuwait                        | Asia/Macao                         | Asia/Macau                         |
| Asia/Magadan                       | Asia/Makassar                      | Asia/Manila                        |
| Asia/Muscat                        | Asia/Nicosia                       | Asia/Novokuznetsk                  |
| Asia/Novosibirsk                   | Asia/Omsk                          | Asia/Oral                          |
| Asia/Phnom_Penh                    | Asia/Pontianak                     | Asia/Pyongyang                     |
| Asia/Qatar                         | Asia/Qostanay                      | Asia/Qyzylorda                     |
| Asia/Rangoon                       | Asia/Riyadh                        | Asia/Saigon                        |
| Asia/Sakhalin                      | Asia/Samarkand                     | Asia/Seoul                         |
| Asia/Shanghai                      | Asia/Singapore                     | Asia/Srednekolymsk                 |
| Asia/Taipei                        | Asia/Tashkent                      | Asia/Tbilisi                       |
| Asia/Tehran                        | Asia/Tel_Aviv                      | Asia/Thimbu                        |
| Asia/Thimphu                       | Asia/Tokyo                         | Asia/Tomsk                         |
| Asia/Ujung_Pandang                 | Asia/Ulaanbaatar                   | Asia/Ulan_Bator                    |
| Asia/Urumqi                        | Asia/Ust-Nera                      | Asia/Vientiane                     |
| Asia/Vladivostok                   | Asia/Yakutsk                       | Asia/Yangon                        |
| Asia/Yekaterinburg                 | Asia/Yerevan                       | Atlantic/Azores                    |
| Atlantic/Bermuda                   | Atlantic/Canary                    | Atlantic/Cape_Verde                |
| Atlantic/Faeroe                    | Atlantic/Faroe                     | Atlantic/Jan_Mayen                 |
| Atlantic/Madeira                   | Atlantic/Reykjavik                 | Atlantic/South_Georgia             |
| Atlantic/St_Helena                 | Atlantic/Stanley                   | Australia/ACT                      |
| Australia/Adelaide                 | Australia/Brisbane                 | Australia/Broken_Hill              |
| Australia/Canberra                 | Australia/Currie                   | Australia/Darwin                   |
| Australia/Eucla                    | Australia/Hobart                   | Australia/LHI                      |
| Australia/Lindeman                 | Australia/Lord_Howe                | Australia/Melbourne                |
| Australia/NSW                      | Australia/North                    | Australia/Perth                    |
| Australia/Queensland               | Australia/South                    | Australia/Sydney                   |
| Australia/Tasmania                 | Australia/Victoria                 | Australia/West                     |
| Australia/Yancowinna               | Brazil/Acre                        | Brazil/DeNoronha                   |
| Brazil/East                        | Brazil/West                        | CET                                |
| CST6CDT                            | Canada/Atlantic                    | Canada/Central                     |
| Canada/Eastern                     | Canada/Mountain                    | Canada/Newfoundland                |
| Canada/Pacific                     | Canada/Saskatchewan                | Canada/Yukon                       |
| Chile/Continental                  | Chile/EasterIsland                 | Cuba                               |
| EET                                | EST                                | EST5EDT                            |
| Egypt                              | Eire                               | Europe/Amsterdam                   |
| Europe/Andorra                     | Europe/Astrakhan                   | Europe/Athens                      |
| Europe/Belfast                     | Europe/Belgrade                    | Europe/Berlin                      |
| Europe/Bratislava                  | Europe/Brussels                    | Europe/Bucharest                   |
| Europe/Budapest                    | Europe/Busingen                    | Europe/Chisinau                    |
| Europe/Copenhagen                  | Europe/Dublin                      | Europe/Gibraltar                   |
| Europe/Guernsey                    | Europe/Helsinki                    | Europe/Isle_of_Man                 |
| Europe/Istanbul                    | Europe/Jersey                      | Europe/Kaliningrad                 |
| Europe/Kiev                        | Europe/Kirov                       | Europe/Kyiv                        |
| Europe/Lisbon                      | Europe/Ljubljana                   | Europe/London                      |
| Europe/Luxembourg                  | Europe/Madrid                      | Europe/Malta                       |
| Europe/Mariehamn                   | Europe/Minsk                       | Europe/Monaco                      |
| Europe/Moscow                      | Europe/Nicosia                     | Europe/Oslo                        |
| Europe/Paris                       | Europe/Podgorica                   | Europe/Prague                      |
| Europe/Riga                        | Europe/Rome                        | Europe/Samara                      |
| Europe/San_Marino                  | Europe/Sarajevo                    | Europe/Saratov                     |
| Europe/Simferopol                  | Europe/Skopje                      | Europe/Sofia                       |
| Europe/Stockholm                   | Europe/Tallinn                     | Europe/Tirane                      |
| Europe/Tiraspol                    | Europe/Ulyanovsk                   | Europe/Uzhgorod                    |
| Europe/Vaduz                       | Europe/Vatican                     | Europe/Vienna                      |
| Europe/Vilnius                     | Europe/Volgograd                   | Europe/Warsaw                      |
| Europe/Zagreb                      | Europe/Zaporozhye                  | Europe/Zurich                      |
| Factory                            | GB                                 | GB-Eire                            |
| GMT                                | GMT+0                              | GMT-0                              |
| GMT0                               | Greenwich                          | HST                                |
| Hongkong                           | Iceland                            | Indian/Antananarivo                |
| Indian/Chagos                      | Indian/Christmas                   | Indian/Cocos                       |
| Indian/Comoro                      | Indian/Kerguelen                   | Indian/Mahe                        |
| Indian/Maldives                    | Indian/Mauritius                   | Indian/Mayotte                     |
| Indian/Reunion                     | Iran                               | Israel                             |
| Jamaica                            | Japan                              | Kwajalein                          |
| Libya                              | MET                                | MST                                |
| MST7MDT                            | Mexico/BajaNorte                   | Mexico/BajaSur                     |
| Mexico/General                     | NZ                                 | NZ-CHAT                            |
| Navajo                             | PRC                                | PST8PDT                            |
| Pacific/Apia                       | Pacific/Auckland                   | Pacific/Bougainville               |
| Pacific/Chatham                    | Pacific/Chuuk                      | Pacific/Easter                     |
| Pacific/Efate                      | Pacific/Enderbury                  | Pacific/Fakaofo                    |
| Pacific/Fiji                       | Pacific/Funafuti                   | Pacific/Galapagos                  |
| Pacific/Gambier                    | Pacific/Guadalcanal                | Pacific/Guam                       |
| Pacific/Honolulu                   | Pacific/Johnston                   | Pacific/Kanton                     |
| Pacific/Kiritimati                 | Pacific/Kosrae                     | Pacific/Kwajalein                  |
| Pacific/Majuro                     | Pacific/Marquesas                  | Pacific/Midway                     |
| Pacific/Nauru                      | Pacific/Niue                       | Pacific/Norfolk                    |
| Pacific/Noumea                     | Pacific/Pago_Pago                  | Pacific/Palau                      |
| Pacific/Pitcairn                   | Pacific/Pohnpei                    | Pacific/Ponape                     |
| Pacific/Port_Moresby               | Pacific/Rarotonga                  | Pacific/Saipan                     |
| Pacific/Samoa                      | Pacific/Tahiti                     | Pacific/Tarawa                     |
| Pacific/Tongatapu                  | Pacific/Truk                       | Pacific/Wake                       |
| Pacific/Wallis                     | Pacific/Yap                        | Poland                             |
| Portugal                           | ROC                                | ROK                                |
| Singapore                          | Turkey                             | UCT                                |
| US/Alaska                          | US/Aleutian                        | US/Arizona                         |
| US/Central                         | US/East-Indiana                    | US/Eastern                         |
| US/Hawaii                          | US/Indiana-Starke                  | US/Michigan                        |
| US/Mountain                        | US/Pacific                         | US/Samoa                           |
| UTC                                | Universal                          | W-SU                               |
| WET                                | Zulu                               |                                    |

## Requirements

- Python 3.12+

## License

MIT

