{"id":"55357364e02d480d0003c6d3","name":"GoFormz Api","subdomain":"goformz","versions":[{"_id":"553591cd63cc650d00312925","releaseDate":"2015-04-20T23:54:53.134Z","is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},{"_id":"5632491b9c25801700dac427","releaseDate":"2015-10-29T16:28:11.665Z","is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"","version_clean":"3.0.0","version":"3"}],"current_version":{"version_clean":"2.0.0","version":"2"},"oauth":{"enabled":false},"api":{"name":"","url":"https://api.goformz.com/v:version","contenttype":"json","auth":"basic","explorer":false,"proxyEnabled":true,"jwt":false,"authextra":[],"headers":[],"object_definitions":[]},"apiAlt":[{"_id":"59a5fbbaea354a00393a44df","object_definitions":[],"headers":[],"authextra":[],"jwt":false,"proxyEnabled":true,"explorer":false,"auth":"basic","contenttype":"json","url":"https://api.goformz.com/scim/v:version","name":"SCIM"}],"plan_details":{"name":"Developer Hub","is_active":true,"cost":59,"versions":10000,"custom_domain":true,"custom_pages":true,"whitelabel":false,"errors":false,"password":true,"landing_page":true,"stylesheet":true,"javascript":false,"html":true,"extra_html":false,"admins":true},"intercom":"","intercom_secure_emailonly":false,"flags":{"allow_hub2":false,"hub2":false,"migrationRun":false,"oauth":false,"swagger":false,"correctnewlines":false,"speedyRender":false,"allowXFrame":false,"jwt":false,"hideGoogleAnalytics":false,"stripe":false,"disableDiscuss":false,"newApiExplorer":false,"autoSslGeneration":true,"ssl":false},"asset_base_url":""}

{"_id":"5536e797b91d030d004c3d91","githubsync":"","project":"55357364e02d480d0003c6d3","category":{"_id":"5536e6bf7fe60f0d000fd1c0","__v":18,"pages":["5536e6ed9f7f2d0d00b1cd56","5536e736bbb4a70d00a53534","5536e73f9f7f2d0d00b1cd59","5536e74dbbb4a70d00a53536","5536e7569f7f2d0d00b1cd5b","5536e7609f7f2d0d00b1cd5d","5536e76b20d5ca0d0001580d","5536e78220d5ca0d0001580f","5536e797b91d030d004c3d91","5536e7a120d5ca0d00015811","5536e7b320d5ca0d00015813","5536e7bbbbb4a70d00a5353a","5536e7c99f7f2d0d00b1cd60","5536e7d29030530d0007f860","5536e7dbbbb4a70d00a5353c","5536e7e69f7f2d0d00b1cd62","5571ef581cd8283500a8b4de","55b80d6be89bbf25009f045b"],"project":"55357364e02d480d0003c6d3","version":"553591cd63cc650d00312925","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-04-22T00:09:35.017Z","from_sync":false,"order":9,"slug":"form-fields","title":"Form Fields"},"__v":2,"user":"55356ede6040a20d00454508","version":{"_id":"553591cd63cc650d00312925","project":"55357364e02d480d0003c6d3","__v":13,"forked_from":"55357365e02d480d0003c6d6","createdAt":"2015-04-20T23:54:53.134Z","releaseDate":"2015-04-20T23:54:53.134Z","categories":["553591cd63cc650d00312926","553591cd63cc650d00312927","5536e4d39f7f2d0d00b1cd54","5536e55c20d5ca0d0001580a","5536e6bf7fe60f0d000fd1c0","5536f5bba171250d00c00556","553a974369c2630d00a8562e","553a97c60074c80d00621c2a","553a98332af5f20d000fc32a","553a9b9869c2630d00a85642","556e0f23d02e0b190042f13d","563249b1dcc27a1700823650","5639113f049e420d00476b03","59a5dd94aaa11d003334edb4"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"parentDoc":null,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-04-22T00:13:11.458Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"The DateTime Field stores both a date and time value within the property, `value`.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n\\t\\t\\\"Signature Timestamp\\\": {\\n      \\\"displayValue\\\": \\\"4/13/2015 9:20 AM\\\",\\n      \\\"value\\\": \\\"2015-04-13T09:20:00Z\\\",\\n      \\\"id\\\": \\\"83fc55d4-274b-4b97-a56c-a479010b6faa\\\",\\n      \\\"name\\\": \\\"Signature Timestamp\\\",\\n      \\\"type\\\": \\\"DateTime\\\"\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"NOTE:\",\n  \"body\": \"The id, name, and type are not necessary when creating or updating a form, they are returned in the `JSON` of a request for readability.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Value\"\n}\n[/block]\nThe `value` property of the Date Field expects the date in the [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format and more specifically in [UTC](http://en.wikipedia.org/wiki/Coordinated_Universal_Time).  \n\nThe expected format takes the following form, YYYY-MM-DDThh:mm:ssZ, where:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Format\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"YYYY\",\n    \"1-0\": \"MM\",\n    \"2-0\": \"DD\",\n    \"3-0\": \"hh\",\n    \"4-0\": \"mm\",\n    \"5-0\": \"ss\",\n    \"0-1\": \"A four-digit year, 0000 through 9999.\",\n    \"1-1\": \"A two-digit month of the year, 01 through 12.\",\n    \"2-1\": \"A two-digit day of that month, 01 through 31.\",\n    \"3-1\": \"Zero-padded hour between 00 and 23\",\n    \"4-1\": \"A zero-padded minute between 00 and 59\",\n    \"5-1\": \"A zero-padded second between 00 and 60 (where 60 is only used to denote an added leap second).\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\nAs an example, to set a DateTime Field to 1:30:25 PM on April 27th, 2015  the following format would be used:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n\\t\\\"value\\\": \\\"2015-04-27T13:30:25Z\\\"\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Display Value\"\n}\n[/block]\nThe `displayValue` property of a DateTime Field is read-only.  This means any change to this property will not be persisted after initially setting or updating a DateTime Field.  \n\nThe `displayValue` property presents the `value` property as a formatted `string` which is defined by the template rules.","excerpt":"","slug":"datetime-field","type":"basic","title":"DateTime Field"}

DateTime Field

The DateTime Field stores both a date and time value within the property, `value`. [block:code] { "codes": [ { "code": "{\n\t\t\"Signature Timestamp\": {\n \"displayValue\": \"4/13/2015 9:20 AM\",\n \"value\": \"2015-04-13T09:20:00Z\",\n \"id\": \"83fc55d4-274b-4b97-a56c-a479010b6faa\",\n \"name\": \"Signature Timestamp\",\n \"type\": \"DateTime\"\n }\n}", "language": "json" } ] } [/block] [block:callout] { "type": "info", "title": "NOTE:", "body": "The id, name, and type are not necessary when creating or updating a form, they are returned in the `JSON` of a request for readability." } [/block] [block:api-header] { "type": "basic", "title": "Value" } [/block] The `value` property of the Date Field expects the date in the [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format and more specifically in [UTC](http://en.wikipedia.org/wiki/Coordinated_Universal_Time). The expected format takes the following form, YYYY-MM-DDThh:mm:ssZ, where: [block:parameters] { "data": { "h-0": "Format", "h-1": "Description", "0-0": "YYYY", "1-0": "MM", "2-0": "DD", "3-0": "hh", "4-0": "mm", "5-0": "ss", "0-1": "A four-digit year, 0000 through 9999.", "1-1": "A two-digit month of the year, 01 through 12.", "2-1": "A two-digit day of that month, 01 through 31.", "3-1": "Zero-padded hour between 00 and 23", "4-1": "A zero-padded minute between 00 and 59", "5-1": "A zero-padded second between 00 and 60 (where 60 is only used to denote an added leap second)." }, "cols": 2, "rows": 6 } [/block] As an example, to set a DateTime Field to 1:30:25 PM on April 27th, 2015 the following format would be used: [block:code] { "codes": [ { "code": "{\n\t\"value\": \"2015-04-27T13:30:25Z\"\n}", "language": "json" } ] } [/block] [block:api-header] { "type": "basic", "title": "Display Value" } [/block] The `displayValue` property of a DateTime Field is read-only. This means any change to this property will not be persisted after initially setting or updating a DateTime Field. The `displayValue` property presents the `value` property as a formatted `string` which is defined by the template rules.