Android时间格式化：解决Locale特定AM/PM字符串过长问题

本文旨在解决Android应用中，特定语言环境（如亚美尼亚语`hy`）下，`SimpleDateFormat`或`TextClock`生成冗长AM/PM字符串（如"կեսօրից առաջ"）导致UI显示异常的问题。我们将深入探讨`Locale`与`DateFormatSymbols`的交互，提供通过显式设置AM/PM字符串或选择特定`Locale`来控制时间格式的解决方案，并讨论`TextClock`的限制及替代方案，确保时间显示简洁准确。

理解Locale与时间格式化中的AM/PM字符串

在Android开发中，处理日期和时间格式化是常见的任务。java.text.SimpleDateFormat是一个强大的工具，它允许开发者根据特定的模式字符串和语言环境（Locale）来格式化日期和时间。其中，模式字母a（或aa）用于表示AM/PM标记。

然而，SimpleDateFormat在渲染AM/PM标记时，会根据其初始化时指定的Locale来查找对应的DateFormatSymbols。某些语言环境，例如亚美尼亚语（hy），其DateFormatSymbols中为AM/PM定义的字符串可能非常冗长（例如，"կեսօրից առաջ"意为“中午之前”）。当这些长字符串在有限的UI空间（如TextClock或自定义TextView）中显示时，就会导致布局溢出或显示不全的问题。

例如，以下代码在hy语言环境下可能会产生冗长的AM/PM字符串：

DateFormat timeOnly = new SimpleDateFormat("h:mm aa", new Locale("hy"));
Date fullDate = new Date();
String callTime = timeOnly.format(fullDate);
// callTime might be something like "9:00 կեսօրից առաջ"

即使尝试通过Settings.System.putString(getContentResolver(), Settings.System.TIME_12_24, "12");设置12小时制，或通过DateFormatSymbols手动设置AM/PM字符串，也可能因为不清楚如何将其应用于实际格式化过程而无法解决问题。

解决方案：控制SimpleDateFormat的AM/PM字符串

解决此问题的核心在于如何控制SimpleDateFormat在格式化时使用的AM/PM字符串。我们有两种主要方法：

方法一：显式设置DateFormatSymbols

这种方法允许你保留原始Locale的其他日期时间格式，但只自定义AM/PM字符串。这是最灵活的方法，尤其当你希望AM/PM标记是特定短语（如"AM", "PM"或自定义的短缩语）时。

Cutout.Pro抠图

AI批量抠图去背景

66

查看详情

1. 创建一个DateFormatSymbols实例，可以基于目标Locale。
2. 使用setAmPmStrings()方法设置你想要的AM和PM字符串数组。
3. 将这个自定义的DateFormatSymbols应用到你的SimpleDateFormat实例。

// 假设我们希望在hy语言环境下显示“AM”和“PM”
Locale targetLocale = new Locale("hy");

// 创建一个基于目标Locale的DateFormatSymbols
DateFormatSymbols customSymbols = new DateFormatSymbols(targetLocale);

// 设置自定义的AM/PM字符串
// 如果希望是亚美尼亚语的缩写，可以是 {"ԿԱ", "ԿՀ"}
customSymbols.setAmPmStrings(new String[]{"AM", "PM"});

// 创建SimpleDateFormat，并应用自定义的DateFormatSymbols
SimpleDateFormat customFormatter = new SimpleDateFormat("h:mm aa", targetLocale);
customFormatter.setDateFormatSymbols(customSymbols);

// 获取当前时间并格式化
Date now = new Date();
String formattedTime = customFormatter.format(now);
System.out.println("Formatted with custom AM/PM: " + formattedTime);
// 示例输出: Formatted with custom AM/PM: 9:00 AM

方法二：使用特定Locale进行AM/PM格式化

如果你不关心其他语言环境特定的日期时间格式，只希望AM/PM标记始终是标准的"AM"/"PM"，那么可以在创建SimpleDateFormat时直接指定一个已知会产生简洁AM/PM标记的Locale，例如Locale.ENGLISH或Locale.ROOT。

// 使用Locale.ENGLISH来确保AM/PM字符串是"AM"或"PM"
SimpleDateFormat englishAmPmFormatter = new SimpleDateFormat("h:mm aa", Locale.ENGLISH);

Date now = new Date();
String formattedTime = englishAmPmFormatter.format(now);
System.out.println("Formatted with English AM/PM: " + formattedTime);
// 示例输出: Formatted with English AM/PM: 9:00 AM

解析与格式化时间字符串的示例

在某些场景下，你可能需要从一个已有的时间字符串（例如，从数据库读取的24小时制时间）中解析出时间，然后再将其格式化为带有简洁AM/PM标记的12小时制。以下示例结合了时间解析和上述格式化方法：

import java.text.DateFormatSymbols;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;

public class TimeFormatterExample {
    public static void main(String[] args) {
        // 模拟从源获取的24小时制时间字符串
        String startTime24Hour = "21:06:30"; // 晚上9点06分30秒

        // 步骤1: 解析24小时制时间字符串
        // 使用Locale.ROOT避免解析时受默认Locale影响
        SimpleDateFormat parser = new SimpleDateFormat("HH:mm:ss", Locale.ROOT);
        Date parsedDate = null;
        try {
            parsedDate = parser.parse(startTime24Hour);
        } catch (ParseException e) {
            System.err.println("Error parsing time: " + e.getMessage());
            e.printStackTrace();
            return; // 错误处理
        }

        if (parsedDate != null) {
            System.out.println("Parsed Date: " + parsedDate);

            // 步骤2: 格式化为带有简洁AM/PM的12小时制

            // 选项A: 使用自定义的AM/PM字符串（例如，强制为"AM"/"PM"）
            Locale targetLocale = new Locale("hy"); // 保持其他格式为hy，只改AM/PM
            DateFormatSymbols customSymbols = new DateFormatSymbols(targetLocale);
            customSymbols.setAmPmStrings(new String[]{"AM", "PM"}); // 可以是任何你想要的短字符串
            SimpleDateFormat formatterWithCustomAmPm = new SimpleDateFormat("h:mm aa", targetLocale);
            formatterWithCustomAmPm.setDateFormatSymbols(customSymbols);
            String formattedTimeA = formatterWithCustomAmPm.format(parsedDate);
            System.out.println("Formatted (Custom AM/PM): " + formattedTimeA); // 示例输出: 9:06 PM

            // 选项B: 使用Locale.ENGLISH来确保AM/PM字符串是"AM"或"PM"
            SimpleDateFormat formatterEnglishAmPm = new SimpleDateFormat("h:mm aa", Locale.ENGLISH);
            String formattedTimeB = formatterEnglishAmPm.format(parsedDate);
            System.out.println("Formatted (English AM/PM): " + formattedTimeB); // 示例输出: 9:06 PM

            // 选项C: 默认Locale下的AM/PM（此方法在原问题中，如果Locale.getDefault()是英文则有效）
            // 注意：如果Locale.getDefault()是hy，仍可能出现长字符串
            SimpleDateFormat defaultAmPmFormatter = new SimpleDateFormat("h:mm a");
            String formattedTimeC = defaultAmPmFormatter.format(parsedDate);
            System.out.println("Formatted (Default Locale AM/PM): " + formattedTimeC); // 示例输出: 9:06 PM
        }
    }
}

上述示例中的Option C与原始问题答案提供的解决方案类似。它没有明确指定Locale，因此会使用Locale.getDefault()。如果在运行环境（如Java Fiddle）中Locale.getDefault()是英文或其他支持简洁AM/PM的语言，则会得到"AM"或"PM"。但在Android设备上，如果系统Locale被设置为hy，则Locale.getDefault()也会是hy，从而导致长字符串。因此，为了确保跨设备和Locale的一致性，推荐使用Option A或Option B。

TextClock的局限性与替代方案

TextClock是一个方便的UI组件，可以自动显示当前时间。然而，它在自定义DateFormatSymbols方面存在局限性。TextClock通常依赖于系统Locale和android:format12Hour或android:format24Hour属性来决定显示格式。它没有直接的API来注入自定义的DateFormatSymbols。

如果TextClock无法满足你的定制需求（例如，无法解决冗长AM/PM字符串的问题），建议采用以下替代方案：

1. 使用TextView并手动更新： 创建一个普通的TextView，然后使用Handler或Timer每秒更新其文本内容。在更新逻辑中，你可以使用上述的SimpleDateFormat方法来格式化时间，从而完全控制AM/PM字符串的显示。

   // 假设在Activity或Fragment中
   private TextView timeTextView;
   private Handler handler = new Handler(Looper.getMainLooper());
   private Runnable updateTimeRunnable;
   
   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_main);
       timeTextView = findViewById(R.id.my_time_text_view);
   
       // 初始化自定义的SimpleDateFormat
       Locale targetLocale = new Locale("hy");
       DateFormatSymbols customSymbols = new DateFormatSymbols(targetLocale);
       customSymbols.setAmPmStrings(new String[]{"AM", "PM"});
       final SimpleDateFormat customFormatter = new SimpleDateFormat("h:mm aa", targetLocale);
       customFormatter.setDateFormatSymbols(customSymbols);
   
       updateTimeRunnable = new Runnable() {
           @Override
           public void run() {
               String formattedTime = customFormatter.format(new Date());
               timeTextView.setText(formattedTime);
               handler.postDelayed(this, 1000); // 每秒更新
           }
       };
   }
   
   @Override
   protected void onResume() {
       super.onResume();
       handler.post(updateTimeRunnable); // 开始更新
   }
   
   @Override
   protected void onPause() {
       super.onPause();
       handler.removeCallbacks(updateTimeRunnable); // 停止更新
   }

   登录后复制

2. 考虑使用java.time API (ThreeTenABP)： 对于API 26及更高版本的Android，推荐使用java.time包（JSR 310）提供的现代日期时间API。对于API 19等旧版本，可以使用ThreeTenABP库来反向移植这些功能。java.time.format.DateTimeFormatter提供了更强大的本地化和自定义选项。

   // 假设使用ThreeTenABP
   import org.threeten.bp.LocalTime;
   import org.threeten.bp.format.DateTimeFormatter;
   import org.threeten.bp.format.DateTimeFormatterBuilder;
   import org.threeten.bp.format.TextStyle;
   import org.threeten.bp.temporal.ChronoField;
   
   // ... 在onCreate或需要的地方 ...
   // 定义自定义的AM/PM文本
   Map<Long, String> amPmMap = new HashMap<>();
   amPmMap.put(0L, "AM"); // AM = 0
   amPmMap.put(1L, "PM"); // PM = 1
   
   // 创建一个DateTimeFormatter，并自定义AM/PM文本
   DateTimeFormatter customTimeFormatter = new DateTimeFormatterBuilder()
       .appendPattern("h:mm ")
       .appendText(ChronoField.AMPM_OF_DAY, amPmMap) // 使用自定义的AM/PM文本
       .toFormatter(new Locale("hy")); // 保持其他格式为hy
   
   String formattedTime = LocalTime.now().format(customTimeFormatter);
   System.out.println("Formatted with ThreeTenABP custom AM/PM: " + formattedTime);
   // 示例输出: Formatted with ThreeTenABP custom AM/PM: 9:00 AM

   登录后复制

注意事项与最佳实践

• 始终指定Locale： 在创建SimpleDateFormat实例时，尽量明确指定Locale，避免使用无参数构造函数，因为它依赖于Locale.getDefault()，这可能导致在不同设备或系统设置下行为不一致。
• 测试多语言环境： 在发布应用之前，务必在不同的语言环境下测试你的时间格式化逻辑，尤其是那些可能产生长字符串的Locale。
• 性能考量： 如果需要频繁格式化时间（例如，每秒更新UI），应在循环外部创建并初始化SimpleDateFormat实例，避免在每次迭代中重复创建对象，以提高性能。
• 用户体验： 考虑目标用户的语言习惯。如果用户习惯了

以上就是Android时间格式化：解决Locale特定AM/PM字符串过长问题的详细内容，更多请关注php中文网其它相关文章！