使用 DateFormat 处理日期

本课属于 Coddy Flutter 学习旅程的“数据与网络”单元。第 20 课，共 27 课。

服务器会以一种固定格式发送日期文本，例如 "2026-11-03T18:30:00"：年、月、日，然后是时间。DateTime.parse 会将这段文本转换为 DateTime。直接打印时，DateTime 看起来像 2026-11-03 18:30:00.000，没人想在手机上读这种格式。

intl 库可以将日期格式化成方便人们阅读的形式。DateFormat 接收一个模式，其中的字母代表日期的各个部分：

import 'package:intl/intl.dart';

final day = DateTime.parse('2026-11-03T18:30:00');
DateFormat('EEE, MMM d').format(day)    // Tue, Nov 3
DateFormat('EEEE d MMMM').format(day)   // Tuesday 3 November

E 表示星期几，M 表示月份，d 表示一个月中的日期。字母越多，格式越完整：EEE 是 Tue，EEEE 是 Tuesday，MMM 是 Nov，MMMM 是 November，MM 是 11。大小写很重要：D 表示一年中的第几天。模式中的逗号和空格会保持原样。

挑战

简单

活动列表显示的是原始日期。用 DateFormat 格式化每个日期，让第一个活动显示为 Tue, Nov 3。intl 已经导入。

亲手试试

import 'dart:convert';

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

import 'api.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      debugShowCheckedModeBanner: false,
      home: EventsScreen(),
    );
  }
}

class EventsScreen extends StatefulWidget {
  const EventsScreen({super.key});

  @override
  State<EventsScreen> createState() => _EventsScreenState();
}

class _EventsScreenState extends State<EventsScreen> {
  late Future<List<Event>> _events;

  @override
  void initState() {
    super.initState();
    _events = loadEvents();
  }

  Future<List<Event>> loadEvents() async {
    final body = await fetch('/events');
    final items = jsonDecode(body) as List<dynamic>;
    return items.map((item) => Event.fromJson(item as Map<String, dynamic>)).toList();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Events')),
      body: FutureBuilder<List<Event>>(
        future: _events,
        builder: (context, snapshot) {
          if (snapshot.hasError) {
            return Center(child: Text('Could not load: ${snapshot.error}'));
          }
          if (snapshot.hasData) {
            final events = snapshot.data!;
            return ListView.builder(
              itemCount: events.length,
              itemBuilder: (context, index) {
                final event = events[index];
                return ListTile(
                  title: Text(event.title),
                  subtitle: Text('${event.start}'),
                );
              },
            );
          }
          return const Center(child: CircularProgressIndicator());
        },
      ),
    );
  }
}

class Event {
  Event({required this.title, required this.start});

  final String title;
  final DateTime start;

  factory Event.fromJson(Map<String, dynamic> json) {
    return Event(
      title: json['title'] as String,
      start: DateTime.parse(json['start'] as String),
    );
  }
}

自我测试

这节课包含一个小测验。开始学习即可作答，并记录你的进度。

数据与网络中的所有课

自己练习： Flutter 在线编译器