Tweet

国際化プログラミングにおける一般的な注意点
サーバーサイドプログラミング

1. ユーザーロケールの認識
   
   メッセージ、ラベル、日付、通貨、その他の文化に関連する情報は、サーバーでなくユーザーの言語(ロケール)に沿って表示されるべきです。
   ユーザーロケールは各ブラウザからHTTPリクエストとしてサーバーへ送られるので、それらをサーバーの処理へ適用させる必要があります。 忘れてならないのは、通常のプログラミングは実行プラットフォーム(サーバーOS)のロケールをアプリケーションへ適用させるということです。
   以下は各言語のサーバー処理のサンプルコードです。
   
   
   • リソースの読み込み (メッセージ/ラベル)
     
     
     • Java (JSP/Servlet)
       

       //デフォルト言語を英語に設定。
       java.util.Locale.setDefault(new java.util.Locale("en",""));
       //ユーザー言語(ユーザーのブラウザにより設定)のリソースを読み込む。
       java.util.ResourceBundle wwnaviBundle = 
           java.util.ResourceBundle.getBundle("wwnavi_rs",request.getLocale()); 
           //'request'はJSP内で事前定義された、もしくはServlet内でメソッドの引数として与えられた変数。
       

   • 日付の書式
     
     
     • Java (JSP/Servlet)
       

       //現在の日付をユーザー言語(ユーザーのブラウザにより設定)で表示。
       DateFormat df = 
          DateFormat.getDateTimeInstance(DateFormat.DEFAULT,DateFormat.DEFAULT,request.getLocale());
           //'request'はJSP内で事前定義された、もしくはServlet内でメソッドの引数として与えられた変数。
       String date = df.format(new Date());
       

2. UTF-8エンコーディング
   
   Web UI(HTML)を書くにはUTF-8を使うことが推奨されます。
   Webブラウザの殆どはUTF-8をサポートしており、全ての言語は1つのエンコーディングで出力することができます。
   以下は各言語のサーバー処理のサンプルコードです。
   
   
   • CharsetをUTF-8に設定
     
     
     • Java (JSP/Servlet)
       

       <%@ page contentType="text/html; charset=UTF-8" %> //JSPタグ
       response.setContentType("text/html; charset=UTF-8"); //Servletコード
       

3. データ記憶のための中立フォーマット
   
   日付、通貨、その他の書式データはストレージ(データベースなど)に記憶される時、'何らかの書式'を必要としますが、その時'文化固有'の書式を使った場合、それはそのデータが１つの文化に依存していることを意味します。(例：MySQLに、日付カラムがいつも日本語書式である前堤で日付の値を記憶するコードを書いた場合、アプリケーションは英語設定のMySQLでは動作しないでしょう。)
   データの記憶には、言語設定に関係なく扱えるISO標準書式を使うことが推奨されます。
   以下は各言語のサーバー処理のサンプルコードです。
   
   
   • タイムスタンプの処理
     
     
     • Java (JSP/Servlet)
       

       //タイムスタンプをMySQL内にISO標準書式で保持し、それらをユーザーの書式で表示する。
       
       //MySQL内のタイムスタンプの値
       | edit_date         |
        -------------------
        2010-01-25 00:00:00 
       
       //SQLで値を取りだす。
       String sql = "select edit_date from table1 ...";...
       ResultSet rs = pstmt.executeQuery();...
       Timestamp ts = rs.getTimestamp(0);...
       
       //値をISO標準書式としてパースし、日付オブジェクトを作成する。
       DateFormat df = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss");
       Date date = df.parse(ts.toString());
       
       //日付オブジェクトをユーザー言語(ユーザーのブラウザにより設定)でフォーマットする。
       DateFormat df = 
          DateFormat.getDateTimeInstance(DateFormat.DEFAULT,DateFormat.DEFAULT,request.getLocale());
           //'request'はJSP内で事前定義された、もしくはServlet内でメソッドの引数として与えられた変数。
       out.println(df.format(date));
       

4. UTCとローカル時間
   
   プログラミング言語から取得するサーバー上の現在日付は、サーバーのタイムゾーンに従った時間となります。
   この時間をそのまま使ってしまうと、サーバーのタイムゾーンと異なるタイムゾーンを使うユーザーには、正しい時間として扱われなくなります。
   (例えば、日本にサーバーのあるシステムで、日本の朝9時に更新されたデータの日付は、アメリカのユーザーには前日の夜8時ぐらいに更新されたデータとして表示されなければなりません。その時のアメリカの朝9時は日本のおよそ夜10時ぐらいだからです)
   
   この問題を解決するには、サーバーで扱う時間を世界標準時(UTC)に設定して、ユーザーのタイムゾーンごとに時差計算をして処理する必要があります。
   
   以下は、サーバー上で現在時刻をUTCとして取得し、特定のローカル時間へ変換するサンプルコードです。
   
   
   • UTCとローカル時間の計算
     
     
     • Java
       

       // UTCの取得
       Calendar cal = Calendar.getInstance();
       cal.setTime(new Date());
       
       int offSet = TimeZone.getDefault().getOffset(cal.getTimeInMillis());
       offSet = offSet / 1000;
       cal.add(Calendar.SECOND, -offSet);
       
       Date utcNow = cal.getTime(); 
       
       // UTCからローカルタイムへの変換
       cal = Calendar.getInstance();
       cal.setTime(utcNow);
       
       TimeZone locTz = TimeZone.getTimeZone("Asia/Japan"); (*1)
       int offSet = locTz.getRawOffset();
       offSet = offSet / 1000;
       cal.add(Calendar.SECOND, offSet);
       
       if (locTz.inDaylightTime(cal.getTime())) { (*2)
         cal.add(Calendar.SECOND, locTz.getDSTSavings() / 1000);
       }
       
       Date locDate = cal.getTime();
       
       *1)日本のタイムゾーンを指定しています。
       実際には、アクセスした地域やユーザーの設定からタイムゾーンを特定する必要がありますが、
       これにはタイムゾーンのIDと地域を特定する情報のマッピングデータが必要です。
       
       TimeZoneのIDの一覧はgetAvailableIDsメソッドで取得できます。
       
       クライアントのタイムゾーンの取得については、
       JavaScript国際化プログラミング - ロケール、書式、タイムゾーンもご参照ください。
       
       *2)対象のタイムゾーンがサマータイムを導入しているか判定しています。
       

     • .NET(C++, C#, VB)
       

       
       MSDNライブラリをご参照ください。
       
       

国際化プログラミングトップへ