生成ICS文件时DTSTART未追加UTC标识Z的问题排查

我用Java代码生成ICS文件时，希望DTSTART字段末尾带上UTC标识Z（比如DTSTART:20231110T164148Z），但实际生成的是不带Z的格式（DTSTART:20231110T164148），手动添加Z后能正常使用，请问哪里没做对？

代码如下：

public class IcalGenerator {

    public static void main(String[] args) {

        /* Create the event */
        String eventSummary = "New Year";
        LocalDateTime start = LocalDateTime.now(ZoneId.of("UTC"));
        VEvent event = new VEvent(start, Duration.of(30, ChronoUnit.MINUTES), eventSummary);
        event.add(new Clazz(Clazz.VALUE_PUBLIC));
        event.add(new Description("New meeting"));

        /* Create calendar */
        Calendar icsCalendar = new Calendar();
        var version = new Version();
        version.setValue(Version.VALUE_2_0);
        icsCalendar.add(version);

        // Set the location
        Location location = new Location("Conference Room");

        // Add the Location to the event
        event.add(location);

        /* Add event to calendar */
        icsCalendar.add(event);

        /* Create a file */
        String filePath = "my_meeting.ics";
        FileOutputStream out = null;
        try {

            out = new FileOutputStream(filePath);
            CalendarOutputter outputter = new CalendarOutputter();
            outputter.output(icsCalendar, out);

        } catch (FileNotFoundException e) {
            e.printStackTrace();
        } catch (ValidationException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            if (out != null) {
                try {
                    out.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }

    }
}

问题原因及解决方法 #

问题出在你使用了LocalDateTime类型定义事件起始时间。LocalDateTime本身不包含时区信息，即便调用now(ZoneId.of("UTC"))，也只是获取UTC时间的数值，不会保留时区标记。iCal4j库处理这种无时区的时间时，会生成不带Z标识的DTSTART值。

要生成带Z的UTC时间，需使用带时区信息的日期时间类型，以下两种方案均可：

方案一：用ZonedDateTime替换LocalDateTime #

修改起始时间的创建代码：

ZonedDateTime start = ZonedDateTime.now(ZoneId.of("UTC"));
VEvent event = new VEvent(start, Duration.of(30, ChronoUnit.MINUTES), eventSummary);

ZonedDateTime会完整保留时区信息，iCal4j识别后会自动在DTSTART末尾添加Z标识。

方案二：使用iCal4j自带的DateTime类 #

iCal4j提供的DateTime类原生支持时区，直接创建UTC时间即可：

DateTime start = new DateTime(true); // 参数true表示使用UTC时区
VEvent event = new VEvent(start, Duration.of(30, ChronoUnit.MINUTES), eventSummary);

两种方案都能让生成的DTSTART字段符合DTSTART:YYYYMMDDTHHMMSSZ的格式，无需手动添加Z标识。

内容的提问来源于stack exchange，提问作者Sivaranjani Duraisamy