请求配置

export default getRequestConfig(async ({requestLocale}) => {
  // 通常对应于 `[locale]` 路由段
  const requested = await requestLocale;
  const locale = hasLocale(routing.locales, requested)
    ? requested
    : routing.defaultLocale;
 
  return {
    locale
    // ...
  };
});

export default getRequestConfig(async () => {
  // 提供静态 locale，读取用户设置，
  // 读取 `cookies()`、`headers()` 等
  const locale = 'en';
 
  return {
    locale
    // ...
  };
});

<NextIntlClientProvider locale="en">...</NextIntlClientProvider>

import {getRequestConfig} from 'next-intl/server';
 
export default getRequestConfig(async () => {
  return {
    messages: (await import(`../../messages/${locale}.json`)).default
    // ...
  };
});

// 普通组件
import {useMessages} from 'next-intl';
const messages = useMessages();
 
// 异步服务器组件
import {getMessages} from 'next-intl/server';
const messages = await getMessages();

import {NextIntlClientProvider} from 'next-intl';
import {getMessages} from 'next-intl/server';
import pick from 'lodash/pick';
 
async function Component({children}) {
  // 读取 `i18n/request.ts` 配置的消息
  const messages = await getMessages();
 
  return (
    <NextIntlClientProvider messages={pick(messages, ['Navigation'])}>
      ...
    </NextIntlClientProvider>
  );
}

import {getRequestConfig} from 'next-intl/server';
 
export default getRequestConfig(async () => {
  return {
    // 时区可以静态定义，读取用户配置（如果存储了此设置），
    // 或基于请求动态信息，如 locale 或 cookie。
    timeZone: 'Europe/Vienna'
 
    // ...
  };
});

// 时区可以静态定义，读取用户配置（如果存储了此设置），
// 或基于请求动态信息，如 locale 或 cookie。
const timeZone = 'Europe/Vienna';
 
<NextIntlClientProvider timeZone={timeZone}>...<NextIntlClientProvider>

import {getRequestConfig} from 'next-intl/server';
 
export default getRequestConfig(async () => {
  return {
    now: new Date('2024-11-14T10:36:01.516Z')
 
    // ...
  };
});

const now = new Date('2024-11-14T10:36:01.516Z');
 
<NextIntlClientProvider now={now}>...</NextIntlClientProvider>;

import {getRequestConfig} from 'next-intl/server';
 
export default getRequestConfig(async () => {
  return {
    formats: {
      dateTime: {
        short: {
          day: 'numeric',
          month: 'short',
          year: 'numeric'
        }
      },
      number: {
        precise: {
          maximumFractionDigits: 5
        }
      },
      list: {
        enumeration: {
          style: 'long',
          type: 'conjunction'
        }
      }
    }
 
    // ...
  };
});

<NextIntlClientProvider
  formats={{
    dateTime: {
      short: {
        day: 'numeric',
        month: 'short',
        year: 'numeric'
      }
    },
    number: {
      precise: {
        maximumFractionDigits: 5
      }
    },
    list: {
      enumeration: {
        style: 'long',
        type: 'conjunction'
      }
    }
  }}
>
  ...
</NextIntlClientProvider>

import {getRequestConfig} from 'next-intl/server';
import {IntlErrorCode} from 'next-intl';
 
export default getRequestConfig(async () => {
  return {
    onError(error) {
      if (error.code === IntlErrorCode.MISSING_MESSAGE) {
        // 缺少翻译属于预期，只打印错误日志
        console.error(error);
      } else {
        // 其它错误表示应用有缺陷，应报告
        reportToErrorTracking(error);
      }
    },
 
    getMessageFallback({namespace, key, error}) {
      const path = [namespace, key].filter((part) => part != null).join('.');
 
      if (error.code === IntlErrorCode.MISSING_MESSAGE) {
        return path + ' 尚未翻译';
      } else {
        return '尊敬的开发者，请修复此消息：' + path;
      }
    }
 
    // ...
  };
});

import {NextIntlClientProvider, IntlErrorCode} from 'next-intl';
 
function onError(error) {
  if (error.code === IntlErrorCode.MISSING_MESSAGE) {
    // 缺少翻译属于预期，只打印错误日志
    console.error(error);
  } else {
    // 其它错误表示应用有缺陷，应报告
    reportToErrorTracking(error);
  }
}
 
function getMessageFallback({namespace, key, error}) {
  const path = [namespace, key].filter((part) => part != null).join('.');
 
  if (error.code === IntlErrorCode.MISSING_MESSAGE) {
    return path + ' 尚未翻译';
  } else {
    return '尊敬的开发者，请修复此消息：' + path;
  }
}
 
<NextIntlClientProvider
  onError={onError}
  getMessageFallback={getMessageFallback}
>
  ...
</NextIntlClientProvider>;