abdulsametsahin/php-timezone-converter

php-timezone-converter是一个PHP工具库,用于在Windows和IANA时区之间无缝转换,实现不同系统间的互操作性,并增强日期/时间的处理。适用于需要与各种时区标准兼容的项目。

1.0.1 2024-02-08 15:17 UTC

This package is auto-updated.

Last update: 2024-09-08 16:27:31 UTC


README

PHP时区转换器是一个工具库,用于在Windows和IANA(Olson)时区之间无缝转换,实现不同系统间的互操作性,并增强日期/时间的处理。适用于需要与各种时区标准兼容的项目,这个库简化了转换过程,使您的应用程序更加灵活和用户友好。

特性

  • 从IANA(Olson)时区转换为Windows时区,反之亦然。
  • 简单易用的界面。
  • 支持广泛的PHP版本(>=7.4)。

安装

使用Composer将PHP时区转换器安装到您的项目中

composer require abdulsametsahin/php-timezone-converter

用法

时区转换器可以静态使用,提供直接的方法进行转换

从Olson时区转换为Windows时区

use Abdulsametsahin\TimezoneConverter\TimezoneConverter;

$windowsTimezone = TimezoneConverter::toWindows('Europe/Istanbul');
echo $windowsTimezone; // Outputs corresponding Windows timezone

从Windows时区转换为Olson时区

$olsonTimezone = TimezoneConverter::toOlson('Turkey Standard Time');
echo $olsonTimezone; // Outputs 'Europe/Istanbul'

处理无效时区

如果提供的时区无效或不受支持,两种转换方法都会抛出InvalidArgumentException

try {
    $invalid = TimezoneConverter::toWindows('Invalid/Timezone');
} catch (\InvalidArgumentException $e) {
    echo $e->getMessage(); // Outputs 'Invalid timezone: Invalid/Timezone'
}

要求

  • PHP >= 7.4

贡献

欢迎贡献!请随时提交拉取请求或打开问题以改进库或添加更多功能。