GET times/this_month

Returns this month's prayer times based on given zone.

Resource URL

http://kayrules.com/times/this_month.json

Parameters

Parameter Remark Description
zone Required The location code based on prayer time zones provided by Jakim.
Input: Refer to zone codes here.
format Optional

Options for time formatting
Input: One of the values below.
Default: timestamp

timestamp Show results for prayer times in timestamp format.
12-hour Show results for prayer times in 12-hour format.
24-hour Show results for prayer times in 24-hour format.
pre Optional Show result in preformatted text enclosed with <pre> tags.
Input: true / false
Default: false

Response Fields

Parameter Description
zone The location code based on prayer time zones provided by Jakim. Refer to zone codes here.
start Start date in format `dd-mm-yyyy`.
end End date in format `dd-mm-yyyy`.
locations List of locations identified by Jakim for which having similar prayer timezone.
prayer_times

prayer times information based on the selected zone.

date Date in format `dd-mm-yyyy`.
datestamp Date in unix timestamp (a.k.a. POSIX time or Epoch time) format.
imsak The time period which in Malaysia is equal to 10 minutes before fajr timing.
subuh The time period within which the Fajr daily prayer MUST be performed.
syuruk The time period after the deadline of fajr prayer. It is forbidden to pray during this syuruk time.
zohor The time period within which the Dhuhr daily prayer MUST be performed.
asar The time period within which the Asr daily prayer MUST be performed.
maghrib The time period within which the Maghrib daily prayer MUST be performed.
isyak The time period within which the Isha daily prayer MUST be performed.

Exception Fields

Parameter Description
error_code Return error code `400` for any error occured.
error_type Error types either REQUIRED_FIELD, INVALID_ZONE, LIMIT_EXCEEDED or COMPLEX_ERROR
error_desc

Show error description based on table below

REQUIRED_FIELD Missing Required field.
INVALID_ZONE Invalid zone code given.
LIMIT_EXCEEDED Maximum limit of 365 queries exceeded.
COMPLEX_ERROR Complex error has occured.

Example Request

http://kayrules.com/times/this_month.json?zone=sgr01&format=12-hour

Example Result

{
    "zone": "SGR01",
    "start": "01-06-2017",
    "end": "30-06-2017",
    "locations": [
        "Gombak",
        "Hulu Selangor",
        "Rawang",
        "Hulu Langat",
        "Sepang",
        "Petaling Jaya",
        "Shah Alam"
    ],
    "prayer_times": [
        {
            "date": "01-06-2017",
            "datestamp": 1496246400,
            "imsak": "5:29 am",
            "subuh": "5:39 am",
            "syuruk": "7:02 am",
            "zohor": "1:14 pm",
            "asar": "4:39 pm",
            "maghrib": "7:22 pm",
            "isyak": "8:37 pm"
        },
        {
            "date": "02-06-2017",
            "datestamp": 1496332800,
            "imsak": "5:29 am",
            "subuh": "5:39 am",
            "syuruk": "7:02 am",
            "zohor": "1:14 pm",
            "asar": "4:39 pm",
            "maghrib": "7:23 pm",
            "isyak": "8:38 pm"
        },
        {
            "date": "03-06-2017",
            "datestamp": 1496419200,
            "imsak": "5:29 am",
            "subuh": "5:39 am",
            "syuruk": "7:02 am",
            "zohor": "1:14 pm",
            "asar": "4:39 pm",
            "maghrib": "7:23 pm",
            "isyak": "8:38 pm"
        },
        {
            "date": "04-06-2017",
            "datestamp": 1496505600,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:02 am",
            "zohor": "1:14 pm",
            "asar": "4:39 pm",
            "maghrib": "7:23 pm",
            "isyak": "8:38 pm"
        },
        {
            "date": "05-06-2017",
            "datestamp": 1496592000,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:02 am",
            "zohor": "1:15 pm",
            "asar": "4:40 pm",
            "maghrib": "7:23 pm",
            "isyak": "8:38 pm"
        },
        {
            "date": "06-06-2017",
            "datestamp": 1496678400,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:02 am",
            "zohor": "1:15 pm",
            "asar": "4:40 pm",
            "maghrib": "7:23 pm",
            "isyak": "8:39 pm"
        },
        {
            "date": "07-06-2017",
            "datestamp": 1496764800,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:02 am",
            "zohor": "1:15 pm",
            "asar": "4:40 pm",
            "maghrib": "7:24 pm",
            "isyak": "8:39 pm"
        },
        {
            "date": "08-06-2017",
            "datestamp": 1496851200,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:02 am",
            "zohor": "1:15 pm",
            "asar": "4:40 pm",
            "maghrib": "7:24 pm",
            "isyak": "8:39 pm"
        },
        {
            "date": "09-06-2017",
            "datestamp": 1496937600,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:03 am",
            "zohor": "1:15 pm",
            "asar": "4:41 pm",
            "maghrib": "7:24 pm",
            "isyak": "8:40 pm"
        },
        {
            "date": "10-06-2017",
            "datestamp": 1497024000,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:03 am",
            "zohor": "1:15 pm",
            "asar": "4:41 pm",
            "maghrib": "7:24 pm",
            "isyak": "8:40 pm"
        },
        {
            "date": "11-06-2017",
            "datestamp": 1497110400,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:03 am",
            "zohor": "1:16 pm",
            "asar": "4:41 pm",
            "maghrib": "7:25 pm",
            "isyak": "8:40 pm"
        },
        {
            "date": "12-06-2017",
            "datestamp": 1497196800,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:03 am",
            "zohor": "1:16 pm",
            "asar": "4:42 pm",
            "maghrib": "7:25 pm",
            "isyak": "8:40 pm"
        },
        {
            "date": "13-06-2017",
            "datestamp": 1497283200,
            "imsak": "5:30 am",
            "subuh": "5:40 am",
            "syuruk": "7:03 am",
            "zohor": "1:16 pm",
            "asar": "4:42 pm",
            "maghrib": "7:25 pm",
            "isyak": "8:41 pm"
        },
        {
            "date": "14-06-2017",
            "datestamp": 1497369600,
            "imsak": "5:31 am",
            "subuh": "5:41 am",
            "syuruk": "7:04 am",
            "zohor": "1:16 pm",
            "asar": "4:42 pm",
            "maghrib": "7:25 pm",
            "isyak": "8:41 pm"
        },
        {
            "date": "15-06-2017",
            "datestamp": 1497456000,
            "imsak": "5:31 am",
            "subuh": "5:41 am",
            "syuruk": "7:04 am",
            "zohor": "1:16 pm",
            "asar": "4:42 pm",
            "maghrib": "7:25 pm",
            "isyak": "8:41 pm"
        },
        {
            "date": "16-06-2017",
            "datestamp": 1497542400,
            "imsak": "5:31 am",
            "subuh": "5:41 am",
            "syuruk": "7:04 am",
            "zohor": "1:17 pm",
            "asar": "4:42 pm",
            "maghrib": "7:26 pm",
            "isyak": "8:41 pm"
        },
        {
            "date": "17-06-2017",
            "datestamp": 1497628800,
            "imsak": "5:31 am",
            "subuh": "5:41 am",
            "syuruk": "7:04 am",
            "zohor": "1:17 pm",
            "asar": "4:43 pm",
            "maghrib": "7:26 pm",
            "isyak": "8:42 pm"
        },
        {
            "date": "18-06-2017",
            "datestamp": 1497715200,
            "imsak": "5:31 am",
            "subuh": "5:41 am",
            "syuruk": "7:04 am",
            "zohor": "1:17 pm",
            "asar": "4:43 pm",
            "maghrib": "7:26 pm",
            "isyak": "8:42 pm"
        },
        {
            "date": "19-06-2017",
            "datestamp": 1497801600,
            "imsak": "5:32 am",
            "subuh": "5:42 am",
            "syuruk": "7:05 am",
            "zohor": "1:17 pm",
            "asar": "4:43 pm",
            "maghrib": "7:26 pm",
            "isyak": "8:42 pm"
        },
        {
            "date": "20-06-2017",
            "datestamp": 1497888000,
            "imsak": "5:32 am",
            "subuh": "5:42 am",
            "syuruk": "7:05 am",
            "zohor": "1:18 pm",
            "asar": "4:43 pm",
            "maghrib": "7:27 pm",
            "isyak": "8:42 pm"
        },
        {
            "date": "21-06-2017",
            "datestamp": 1497974400,
            "imsak": "5:32 am",
            "subuh": "5:42 am",
            "syuruk": "7:05 am",
            "zohor": "1:18 pm",
            "asar": "4:44 pm",
            "maghrib": "7:27 pm",
            "isyak": "8:43 pm"
        },
        {
            "date": "22-06-2017",
            "datestamp": 1498060800,
            "imsak": "5:32 am",
            "subuh": "5:42 am",
            "syuruk": "7:05 am",
            "zohor": "1:18 pm",
            "asar": "4:44 pm",
            "maghrib": "7:27 pm",
            "isyak": "8:43 pm"
        },
        {
            "date": "23-06-2017",
            "datestamp": 1498147200,
            "imsak": "5:32 am",
            "subuh": "5:42 am",
            "syuruk": "7:05 am",
            "zohor": "1:18 pm",
            "asar": "4:44 pm",
            "maghrib": "7:27 pm",
            "isyak": "8:43 pm"
        },
        {
            "date": "24-06-2017",
            "datestamp": 1498233600,
            "imsak": "5:33 am",
            "subuh": "5:43 am",
            "syuruk": "7:06 am",
            "zohor": "1:18 pm",
            "asar": "4:44 pm",
            "maghrib": "7:27 pm",
            "isyak": "8:43 pm"
        },
        {
            "date": "25-06-2017",
            "datestamp": 1498320000,
            "imsak": "5:33 am",
            "subuh": "5:43 am",
            "syuruk": "7:06 am",
            "zohor": "1:19 pm",
            "asar": "4:44 pm",
            "maghrib": "7:28 pm",
            "isyak": "8:43 pm"
        },
        {
            "date": "26-06-2017",
            "datestamp": 1498406400,
            "imsak": "5:33 am",
            "subuh": "5:43 am",
            "syuruk": "7:06 am",
            "zohor": "1:19 pm",
            "asar": "4:45 pm",
            "maghrib": "7:28 pm",
            "isyak": "8:44 pm"
        },
        {
            "date": "27-06-2017",
            "datestamp": 1498492800,
            "imsak": "5:33 am",
            "subuh": "5:43 am",
            "syuruk": "7:06 am",
            "zohor": "1:19 pm",
            "asar": "4:45 pm",
            "maghrib": "7:28 pm",
            "isyak": "8:44 pm"
        },
        {
            "date": "28-06-2017",
            "datestamp": 1498579200,
            "imsak": "5:34 am",
            "subuh": "5:44 am",
            "syuruk": "7:07 am",
            "zohor": "1:19 pm",
            "asar": "4:45 pm",
            "maghrib": "7:28 pm",
            "isyak": "8:44 pm"
        },
        {
            "date": "29-06-2017",
            "datestamp": 1498665600,
            "imsak": "5:34 am",
            "subuh": "5:44 am",
            "syuruk": "7:07 am",
            "zohor": "1:19 pm",
            "asar": "4:45 pm",
            "maghrib": "7:28 pm",
            "isyak": "8:44 pm"
        },
        {
            "date": "30-06-2017",
            "datestamp": 1498752000,
            "imsak": "5:34 am",
            "subuh": "5:44 am",
            "syuruk": "7:07 am",
            "zohor": "1:20 pm",
            "asar": "4:45 pm",
            "maghrib": "7:29 pm",
            "isyak": "8:44 pm"
        }
    ]
}