minSdk=21时如何在低版本API中使用OffsetDateTime及setStartTimestamp？

遇到API级别限制的问题很常见，这里有几个靠谱的方案帮你在minSdk21的项目里用上OffsetDateTime：

方案一：使用ThreeTenABP库（最推荐） #

这是专门为Android低版本设计的Java 8时间API兼容库，完美解决JSR-310时间类（包括OffsetDateTime）在低版本上的支持问题：

1. 添加依赖：在你的模块级build.gradle文件中加入：

implementation 'com.jakewharton.threetenabp:threetenabp:1.4.6'

2. 初始化库：在你的Application类的onCreate()方法里初始化：

@Override
public void onCreate() {
    super.onCreate();
    AndroidThreeTen.init(this);
}

3. 正常使用OffsetDateTime：现在你就可以像在API26+上一样调用OffsetDateTime.now()，并且可以直接传入setStartTimestamp()方法，完全兼容API21及以上。

方案二：启用Desugar支持（无需额外第三方库） #

如果你使用的是Android Gradle Plugin 4.0及以上版本，可以通过开启Desugar来让低版本Android支持Java 8的核心库API，包括OffsetDateTime：

1. 配置Desugar：在模块级build.gradle的android块中添加：

compileOptions {
    coreLibraryDesugaringEnabled true
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

2. 添加Desugar依赖：在dependencies块中加入：

coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'

配置完成后，重新同步项目，就可以直接使用OffsetDateTime了，不需要额外的初始化步骤。

方案三：手动兼容（不推荐，繁琐易出错） #

如果不想引入任何依赖，你可以用传统的Calendar、TimeZone和SimpleDateFormat来手动实现类似OffsetDateTime的功能，但这种方法需要自己处理时区偏移、日期时间转换，代码量大且容易出现时区相关的bug，只适合简单场景。举个例子：

// 获取当前时间带偏移量的时间戳
Calendar calendar = Calendar.getInstance();
TimeZone timeZone = calendar.getTimeZone();
int offset = timeZone.getOffset(System.currentTimeMillis()) / 1000; // 偏移秒数
long timestamp = calendar.getTimeInMillis();

// 如果需要转换成OffsetDateTime风格的对象，还需要额外处理

注意事项 #

• 优先选择方案一或方案二，这两种方法都能让你直接使用标准的OffsetDateTime类，避免手动兼容的潜在问题。
• 如果你已经在使用AndroidX，方案二的Desugar支持会更轻量；如果项目比较老旧，ThreeTenABP的兼容性会更稳定。

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