Flutter日出日落时间计算插件suntime的使用

Simple sunrise and sunset time calculation for dart。这是一个简单移植自Python库<suntime>的dart版本。

特性

获取UTC的日出和日落时间。
获取本地或自定义时区的日出和日落时间。

使用方法

一旦导入了库，只需要实例化Sun类并使用它的方法。

import 'package:suntime/suntime.dart';

final latitude = 10.0;
final longitude = -84.0;

const sun = Sun(latitude, longitude);
const date = DateTime.now();

// 获取今天的UTC日出和日落时间。
const sunrise = sun.getSunriseTime(date: date);
const sunset = sun.getSunsetTime(date: date);
print('日出时间: ${sunrise}');
print('日落时间: ${sunset}');

// 或者获取相同的时间，但针对特定时区的位置。
const tzSunrise = sun.getLocalSunriseTime('America/Halifax', date: date);
const tzSunset = sun.getLocalSunsetTime('America/Halifax', date: date);
print('日出时间: ${tzSunrise}');
print('日落时间: ${tzSunset}');

查看示例以获得更详细的用法。

许可证

suntime 是自由软件：你可以根据GNU较宽松公共许可证（LGPL）的条款重新发布它或对其进行修改。具体来说，你可以在许可证的第3版或任何更新版本下进行发布。

suntime 是以希望它有用的方式分发的，但是没有任何形式的保证；甚至没有对适销性或特定用途适用性的默示保证。有关更多详细信息，请参阅GNU较宽松公共许可证。

如果你没有收到一份GNU较宽松公共许可证副本，请参见 http://www.gnu.org/licenses/ 。

示例代码

以下是一个完整的示例代码，展示了如何使用suntime插件来计算不同地点的日出和日落时间。

import 'package:suntime/suntime.dart';

void main() {
  // 实例化Sun对象
  final sun = Sun(9.928069, -84.090725);
  
  // 获取当前日期
  final today = DateTime.now();

  // 打印UTC时的日出时间
  print(
      'UTC日出时间: ${sun.getSunriseTime(date: today.add(const Duration(days: 1)))}');
  
  // 打印美国哥斯达黎加时区的日出时间
  print(
      '哥斯达黎加时区日出时间: ${sun.getLocalSunriseTime('America/Costa_Rica', date: today.add(const Duration(days: 1)))}');
  
  // 打印加拿大哈利法克斯时区的日出时间
  print(
      '哈利法克斯时区日出时间: ${sun.getLocalSunriseTime('America/Halifax', date: today.add(const Duration(days: 1)))}');
  
  // 分隔线
  print('-' * 50);
  
  // 打印UTC时的日落时间
  print('UTC日落时间: ${sun.getSunsetTime()}');
  
  // 打印美国哥斯达黎加时区的日落时间
  print(
      '哥斯达黎加时区日落时间: ${sun.getLocalSunsetTime('America/Costa_Rica')}');
  
  // 打印加拿大哈利法克斯时区的日落时间
  print('哈利法克斯时区日落时间: ${sun.getLocalSunsetTime('America/Halifax')}');

  // 打印管理可能的错误
  final somePlaceInNorthPole = Sun(87.55, 0.1);

  DateTime? sunrise;
  try {
    sunrise = somePlaceInNorthPole.getSunriseTime(date: today);
  } catch (e) {
    print('-' * 50);
    print('SunTimeException发生: $e');
  } finally {
    print('日出时间: $sunrise');
  }
}

上述代码的输出结果如下：

UTC日出时间: 2022-06-07 11:15:00.000Z
哥斯达黎加时区日出时间: 2022-06-07 05:15:00.000-0600
哈利法克斯时区日出时间: 2022-06-07 08:15:00.000-0300
--------------------------------------------------
UTC日落时间: 2022-06-06 23:55:00.000Z
哥斯达黎加时区日落时间: 2022-06-06 17:55:00.000-0600
哈利法克斯时区日落时间: 2022-06-06 20:55:00.000-0300

--------------------------------------------------
SunTimeException发生: The sun never rises on this location (on the specified date)
日出时间: null

yibo5220 1楼

更多关于Flutter日出日落时间计算插件suntime的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

当然，以下是如何在Flutter项目中使用suntime插件来计算日出和日落时间的示例代码。suntime插件是一个用于计算给定地理位置的日出和日落时间的Flutter包。

首先，你需要在你的pubspec.yaml文件中添加suntime依赖项：

dependencies:
  flutter:
    sdk: flutter
  suntime: ^x.y.z  # 请替换为最新的版本号

然后，运行flutter pub get来安装依赖项。

接下来，你可以在你的Flutter应用程序中使用suntime插件。以下是一个完整的示例代码，展示如何使用该插件来计算并显示日出和日落时间：

import 'package:flutter/material.dart';
import 'package:suntime/suntime.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Sunrise and Sunset Calculator',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: SunTimeScreen(),
    );
  }
}

class SunTimeScreen extends StatefulWidget {
  @override
  _SunTimeScreenState createState() => _SunTimeScreenState();
}

class _SunTimeScreenState extends State<SunTimeScreen> {
  String _sunriseTime = '';
  String _sunsetTime = '';

  @override
  void initState() {
    super.initState();
    _calculateSunTimes();
  }

  void _calculateSunTimes() async {
    // 假设我们使用北京的经纬度
    double latitude = 39.9042; // 北京纬度
    double longitude = 116.4074; // 北京经度
    DateTime date = DateTime.now(); // 使用当前日期

    SunTimes sunTimes = await SunTimes.compute(
      latitude: latitude,
      longitude: longitude,
      date: date,
    );

    setState(() {
      _sunriseTime = sunTimes.sunrise.toLocal().toString();
      _sunsetTime = sunTimes.sunset.toLocal().toString();
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Sunrise and Sunset Calculator'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'Sunrise: $_sunriseTime',
              style: TextStyle(fontSize: 24),
            ),
            SizedBox(height: 20),
            Text(
              'Sunset: $_sunsetTime',
              style: TextStyle(fontSize: 24),
            ),
          ],
        ),
      ),
    );
  }
}

在这个示例中，我们创建了一个简单的Flutter应用程序，该应用程序使用suntime插件来计算并显示北京的日出和日落时间。我们在initState方法中调用_calculateSunTimes函数，该函数使用指定的经纬度和当前日期来计算日出和日落时间，并将结果存储在状态变量中。然后，我们在build方法中使用这些状态变量来显示日出和日落时间。

请注意，你需要确保你的设备具有互联网连接，因为suntime插件可能需要网络数据来计算准确的时间（尽管它主要依赖于算法，但在某些情况下可能会使用网络时间进行校准）。此外，请替换示例中的经纬度和日期为你实际需要计算的位置和日期。