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),
    );
  }
}