FileMaker Data API および「FileMaker Data API を実行」ステップにおける日付フォーマット (dateformats) の指定
Claris FileMaker Server 19.6.1 以降、FileMaker Data API に日付フォーマットを制御するオプションが追加されました。
これは「FileMaker Data API を実行」スクリプトステップでも同様に使用可能です。
dateformats - 日付およびタイムスタンプフィールドの形式を指定します。
米国形式の場合は値が 0、ファイルロケールの形式の場合は 1、ISO 8601 形式の場合は 2 です。
指定されていない場合、デフォルト値は 0 です。
FileMaker Data API で、ID による単一レコードの取得、レコードの取得、およびレコード検索のエンドポイントに FileMaker Data API によって返される日付およびタイムスタンプフィールドの形式を制御するオプションの dateformats 引数が含まれるようになりました: 米国は 0、ファイルロケールは 1、ISO8601 は 2 です。
指定されていない場合、デフォルト値は 0 です。
For FileMaker Data API, the Get a Single Record by ID, Get Records, and Find Records endpoints now include the optional dateformats parameter, which controls the format of date and timestamp fields returned by FileMaker Data API: 0 for US, 1 for file locale, or 2 for ISO8601.
If not specified, the default value is 0.
dateformats = 0（米国形式 / デフォルト）
指定がない場合もこの形式になります。戻り値は MM/DD/YYYY 形式です。
リクエストの実行例
{
"layouts": "blank",
"query": [
{
"日付": "03/01/2024"
}
],
"dateformats": 0 <- 米国
}レスポンス結果
{
"response": {
"dataInfo": {
"database": "blank",
"layout": "blank",
"table": "blank",
"totalRecordCount": 1,
"foundCount": 1,
"returnedCount": 1
},
"data": [
{
"fieldData": {
"タイムスタンプ": "03/01/2024 09:10:20", <- 米国
"日付": "03/01/2024" <- 米国
},
"portalData": {},
"recordId": "1",
"modId": "4"
}
]
},
"messages": [
{
"code": "0",
"message": "OK"
}
]
}dateformats = 1（ファイルロケール）
FileMaker ファイル自体のロケール設定（日本であれば YYYY/MM/DD など）に従った形式で返されます。
リクエストの実行例
{
"layouts": "blank",
"query": [
{
"日付": "03/01/2024"
}
],
"dateformats": 1 <- ファイルロケール
}レスポンス結果
{
"response": {
"dataInfo": {
"database": "blank",
"layout": "blank",
"table": "blank",
"totalRecordCount": 1,
"foundCount": 1,
"returnedCount": 1
},
"data": [
{
"fieldData": {
"タイムスタンプ": "2024/03/01 09:10:20", <- ファイルロケール
"日付": "2024/03/01" <- ファイルロケール
},
"portalData": {},
"recordId": "1",
"modId": "4"
}
]
},
"messages": [
{
"code": "0",
"message": "OK"
}
]
}dateformats = 2（ISO8601）
Web API や JavaScript での処理に最適な ISO8601 形式です。
リクエストの実行例
{
"layouts": "blank",
"query": [
{
"日付": "03/01/2024"
}
],
"dateformats": 2 <- ISO8601
}レスポンス結果
{
"response": {
"dataInfo": {
"database": "blank",
"layout": "blank",
"table": "blank",
"totalRecordCount": 1,
"foundCount": 1,
"returnedCount": 1
},
"data": [
{
"fieldData": {
"タイムスタンプ": "2024-03-01T09:10:20", <- ISO8601
"日付": "2024-03-01" <- ISO8601
},
"portalData": {},
"recordId": "1",
"modId": "4"
}
]
},
"messages": [
{
"code": "0",
"message": "OK"
}
]
}