System.Data.SQLite
Hex Artifact Content
Not logged in

Artifact b2380d103315d30ba37fe65b1499f012fedc0ce8:


0000: 3c 21 44 4f 43 54 59 50 45 20 48 54 4d 4c 20 50  <!DOCTYPE HTML P
0010: 55 42 4c 49 43 20 22 2d 2f 2f 57 33 43 2f 2f 44  UBLIC "-//W3C//D
0020: 54 44 20 48 54 4d 4c 20 34 2e 30 31 2f 2f 45 4e  TD HTML 4.01//EN
0030: 22 20 22 68 74 74 70 3a 2f 2f 77 77 77 2e 77 33  " "http://www.w3
0040: 2e 6f 72 67 2f 54 52 2f 68 74 6d 6c 34 2f 73 74  .org/TR/html4/st
0050: 72 69 63 74 2e 64 74 64 22 3e 0a 3c 68 74 6d 6c  rict.dtd">.<html
0060: 3e 3c 68 65 61 64 3e 0a 3c 6d 65 74 61 20 6e 61  ><head>.<meta na
0070: 6d 65 3d 22 76 69 65 77 70 6f 72 74 22 20 63 6f  me="viewport" co
0080: 6e 74 65 6e 74 3d 22 77 69 64 74 68 3d 64 65 76  ntent="width=dev
0090: 69 63 65 2d 77 69 64 74 68 2c 20 69 6e 69 74 69  ice-width, initi
00a0: 61 6c 2d 73 63 61 6c 65 3d 31 2e 30 22 3e 0a 3c  al-scale=1.0">.<
00b0: 6d 65 74 61 20 68 74 74 70 2d 65 71 75 69 76 3d  meta http-equiv=
00c0: 22 63 6f 6e 74 65 6e 74 2d 74 79 70 65 22 20 63  "content-type" c
00d0: 6f 6e 74 65 6e 74 3d 22 74 65 78 74 2f 68 74 6d  ontent="text/htm
00e0: 6c 3b 20 63 68 61 72 73 65 74 3d 55 54 46 2d 38  l; charset=UTF-8
00f0: 22 3e 0a 3c 6c 69 6e 6b 20 68 72 65 66 3d 22 73  ">.<link href="s
0100: 71 6c 69 74 65 2e 63 73 73 22 20 72 65 6c 3d 22  qlite.css" rel="
0110: 73 74 79 6c 65 73 68 65 65 74 22 3e 0a 3c 74 69  stylesheet">.<ti
0120: 74 6c 65 3e 53 51 4c 69 74 65 20 51 75 65 72 79  tle>SQLite Query
0130: 20 4c 61 6e 67 75 61 67 65 3a 20 44 61 74 65 20   Language: Date 
0140: 41 6e 64 20 54 69 6d 65 20 46 75 6e 63 74 69 6f  And Time Functio
0150: 6e 73 3c 2f 74 69 74 6c 65 3e 0a 3c 21 2d 2d 20  ns</title>.<!-- 
0160: 70 61 74 68 3d 20 2d 2d 3e 0a 3c 2f 68 65 61 64  path= -->.</head
0170: 3e 0a 3c 62 6f 64 79 3e 0a 3c 64 69 76 20 63 6c  >.<body>.<div cl
0180: 61 73 73 3d 6e 6f 73 65 61 72 63 68 3e 0a 3c 61  ass=nosearch>.<a
0190: 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68 74 6d   href="index.htm
01a0: 6c 22 3e 0a 3c 69 6d 67 20 63 6c 61 73 73 3d 22  l">.<img class="
01b0: 6c 6f 67 6f 22 20 73 72 63 3d 22 69 6d 61 67 65  logo" src="image
01c0: 73 2f 73 71 6c 69 74 65 33 37 30 5f 62 61 6e 6e  s/sqlite370_bann
01d0: 65 72 2e 67 69 66 22 20 61 6c 74 3d 22 53 51 4c  er.gif" alt="SQL
01e0: 69 74 65 22 20 62 6f 72 64 65 72 3d 22 30 22 3e  ite" border="0">
01f0: 0a 3c 2f 61 3e 0a 3c 64 69 76 3e 3c 21 2d 2d 20  .</a>.<div><!-- 
0200: 49 45 20 68 61 63 6b 20 74 6f 20 70 72 65 76 65  IE hack to preve
0210: 6e 74 20 64 69 73 61 70 70 65 61 72 69 6e 67 20  nt disappearing 
0220: 6c 6f 67 6f 20 2d 2d 3e 3c 2f 64 69 76 3e 0a 3c  logo --></div>.<
0230: 64 69 76 20 63 6c 61 73 73 3d 22 74 61 67 6c 69  div class="tagli
0240: 6e 65 20 64 65 73 6b 74 6f 70 6f 6e 6c 79 22 3e  ne desktoponly">
0250: 0a 53 6d 61 6c 6c 2e 20 46 61 73 74 2e 20 52 65  .Small. Fast. Re
0260: 6c 69 61 62 6c 65 2e 3c 62 72 3e 43 68 6f 6f 73  liable.<br>Choos
0270: 65 20 61 6e 79 20 74 68 72 65 65 2e 0a 3c 2f 64  e any three..</d
0280: 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 22  iv>.<div class="
0290: 6d 65 6e 75 20 6d 61 69 6e 6d 65 6e 75 22 3e 0a  menu mainmenu">.
02a0: 3c 75 6c 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66  <ul>.<li><a href
02b0: 3d 22 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 48 6f  ="index.html">Ho
02c0: 6d 65 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73  me</a>.<li class
02d0: 3d 27 6d 6f 62 69 6c 65 6f 6e 6c 79 27 3e 3c 61  ='mobileonly'><a
02e0: 20 68 72 65 66 3d 22 6a 61 76 61 73 63 72 69 70   href="javascrip
02f0: 74 3a 76 6f 69 64 28 30 29 22 20 6f 6e 63 6c 69  t:void(0)" oncli
0300: 63 6b 3d 27 74 6f 67 67 6c 65 5f 64 69 76 28 22  ck='toggle_div("
0310: 73 75 62 6d 65 6e 75 22 29 27 3e 4d 65 6e 75 3c  submenu")'>Menu<
0320: 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 77  /a>.<li class='w
0330: 69 64 65 6f 6e 6c 79 27 3e 3c 61 20 68 72 65 66  ideonly'><a href
0340: 3d 27 61 62 6f 75 74 2e 68 74 6d 6c 27 3e 41 62  ='about.html'>Ab
0350: 6f 75 74 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73  out</a>.<li clas
0360: 73 3d 27 64 65 73 6b 74 6f 70 6f 6e 6c 79 27 3e  s='desktoponly'>
0370: 3c 61 20 68 72 65 66 3d 22 64 6f 63 73 2e 68 74  <a href="docs.ht
0380: 6d 6c 22 3e 44 6f 63 75 6d 65 6e 74 61 74 69 6f  ml">Documentatio
0390: 6e 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d  n</a>.<li class=
03a0: 27 64 65 73 6b 74 6f 70 6f 6e 6c 79 27 3e 3c 61  'desktoponly'><a
03b0: 20 68 72 65 66 3d 22 64 6f 77 6e 6c 6f 61 64 2e   href="download.
03c0: 68 74 6d 6c 22 3e 44 6f 77 6e 6c 6f 61 64 3c 2f  html">Download</
03d0: 61 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 77 69  a>.<li class='wi
03e0: 64 65 6f 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d  deonly'><a href=
03f0: 27 63 6f 70 79 72 69 67 68 74 2e 68 74 6d 6c 27  'copyright.html'
0400: 3e 4c 69 63 65 6e 73 65 3c 2f 61 3e 0a 3c 6c 69  >License</a>.<li
0410: 20 63 6c 61 73 73 3d 27 64 65 73 6b 74 6f 70 6f   class='desktopo
0420: 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d 22 73 75  nly'><a href="su
0430: 70 70 6f 72 74 2e 68 74 6d 6c 22 3e 53 75 70 70  pport.html">Supp
0440: 6f 72 74 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73  ort</a>.<li clas
0450: 73 3d 27 64 65 73 6b 74 6f 70 6f 6e 6c 79 27 3e  s='desktoponly'>
0460: 3c 61 20 68 72 65 66 3d 22 70 72 6f 73 75 70 70  <a href="prosupp
0470: 6f 72 74 2e 68 74 6d 6c 22 3e 50 75 72 63 68 61  ort.html">Purcha
0480: 73 65 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73  se</a>.<li class
0490: 3d 27 73 65 61 72 63 68 27 20 69 64 3d 27 73 65  ='search' id='se
04a0: 61 72 63 68 5f 6d 65 6e 75 62 75 74 74 6f 6e 27  arch_menubutton'
04b0: 3e 0a 3c 61 20 68 72 65 66 3d 22 6a 61 76 61 73  >.<a href="javas
04c0: 63 72 69 70 74 3a 76 6f 69 64 28 30 29 22 20 6f  cript:void(0)" o
04d0: 6e 63 6c 69 63 6b 3d 27 74 6f 67 67 6c 65 5f 64  nclick='toggle_d
04e0: 69 76 28 22 73 65 61 72 63 68 6d 65 6e 75 22 29  iv("searchmenu")
04f0: 27 3e 53 65 61 72 63 68 3c 2f 61 3e 0a 3c 2f 75  '>Search</a>.</u
0500: 6c 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63  l>.</div>.<div c
0510: 6c 61 73 73 3d 22 6d 65 6e 75 20 73 75 62 6d 65  lass="menu subme
0520: 6e 75 22 20 69 64 3d 22 73 75 62 6d 65 6e 75 22  nu" id="submenu"
0530: 3e 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 61 20 68 72  >.<ul>.<li><a hr
0540: 65 66 3d 27 61 62 6f 75 74 2e 68 74 6d 6c 27 3e  ef='about.html'>
0550: 41 62 6f 75 74 3c 2f 61 3e 0a 3c 6c 69 3e 3c 61  About</a>.<li><a
0560: 20 68 72 65 66 3d 27 64 6f 63 73 2e 68 74 6d 6c   href='docs.html
0570: 27 3e 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 3c  '>Documentation<
0580: 2f 61 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d  /a>.<li><a href=
0590: 27 64 6f 77 6e 6c 6f 61 64 2e 68 74 6d 6c 27 3e  'download.html'>
05a0: 44 6f 77 6e 6c 6f 61 64 3c 2f 61 3e 0a 3c 6c 69  Download</a>.<li
05b0: 3e 3c 61 20 68 72 65 66 3d 27 73 75 70 70 6f 72  ><a href='suppor
05c0: 74 2e 68 74 6d 6c 27 3e 53 75 70 70 6f 72 74 3c  t.html'>Support<
05d0: 2f 61 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d  /a>.<li><a href=
05e0: 27 70 72 6f 73 75 70 70 6f 72 74 2e 68 74 6d 6c  'prosupport.html
05f0: 27 3e 50 75 72 63 68 61 73 65 3c 2f 61 3e 0a 3c  '>Purchase</a>.<
0600: 2f 75 6c 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76  /ul>.</div>.<div
0610: 20 63 6c 61 73 73 3d 22 73 65 61 72 63 68 6d 65   class="searchme
0620: 6e 75 22 20 69 64 3d 22 73 65 61 72 63 68 6d 65  nu" id="searchme
0630: 6e 75 22 3e 0a 3c 66 6f 72 6d 20 6d 65 74 68 6f  nu">.<form metho
0640: 64 3d 22 47 45 54 22 20 61 63 74 69 6f 6e 3d 22  d="GET" action="
0650: 73 65 61 72 63 68 22 3e 0a 3c 73 70 61 6e 20 63  search">.<span c
0660: 6c 61 73 73 3d 22 64 65 73 6b 74 6f 70 6f 6e 6c  lass="desktoponl
0670: 79 22 3e 53 65 61 72 63 68 20 66 6f 72 3a 3c 2f  y">Search for:</
0680: 73 70 61 6e 3e 20 3c 69 6e 70 75 74 20 74 79 70  span> <input typ
0690: 65 3d 22 74 65 78 74 22 20 6e 61 6d 65 3d 22 71  e="text" name="q
06a0: 22 3e 0a 3c 69 6e 70 75 74 20 74 79 70 65 3d 22  ">.<input type="
06b0: 73 75 62 6d 69 74 22 20 76 61 6c 75 65 3d 22 47  submit" value="G
06c0: 6f 22 3e 0a 3c 2f 66 6f 72 6d 3e 0a 3c 2f 64 69  o">.</form>.</di
06d0: 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 73 63 72 69 70  v>.</div>.<scrip
06e0: 74 3e 0a 66 75 6e 63 74 69 6f 6e 20 74 6f 67 67  t>.function togg
06f0: 6c 65 5f 64 69 76 28 6e 6d 29 20 7b 0a 76 61 72  le_div(nm) {.var
0700: 20 77 20 3d 20 64 6f 63 75 6d 65 6e 74 2e 67 65   w = document.ge
0710: 74 45 6c 65 6d 65 6e 74 42 79 49 64 28 6e 6d 29  tElementById(nm)
0720: 3b 0a 69 66 28 20 77 2e 73 74 79 6c 65 2e 64 69  ;.if( w.style.di
0730: 73 70 6c 61 79 3d 3d 22 62 6c 6f 63 6b 22 20 29  splay=="block" )
0740: 7b 0a 77 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61  {.w.style.displa
0750: 79 20 3d 20 22 6e 6f 6e 65 22 3b 0a 7d 65 6c 73  y = "none";.}els
0760: 65 7b 0a 77 2e 73 74 79 6c 65 2e 64 69 73 70 6c  e{.w.style.displ
0770: 61 79 20 3d 20 22 62 6c 6f 63 6b 22 3b 0a 7d 0a  ay = "block";.}.
0780: 7d 0a 66 75 6e 63 74 69 6f 6e 20 64 69 76 5f 6f  }.function div_o
0790: 66 66 28 6e 6d 29 7b 64 6f 63 75 6d 65 6e 74 2e  ff(nm){document.
07a0: 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64 28 6e  getElementById(n
07b0: 6d 29 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79  m).style.display
07c0: 3d 22 6e 6f 6e 65 22 3b 7d 0a 77 69 6e 64 6f 77  ="none";}.window
07d0: 2e 6f 6e 62 65 66 6f 72 65 75 6e 6c 6f 61 64 20  .onbeforeunload 
07e0: 3d 20 66 75 6e 63 74 69 6f 6e 28 65 29 7b 64 69  = function(e){di
07f0: 76 5f 6f 66 66 28 22 73 75 62 6d 65 6e 75 22 29  v_off("submenu")
0800: 3b 7d 0a 2f 2a 20 44 69 73 61 62 6c 65 20 74 68  ;}./* Disable th
0810: 65 20 53 65 61 72 63 68 20 66 65 61 74 75 72 65  e Search feature
0820: 20 69 66 20 77 65 20 61 72 65 20 6e 6f 74 20 6f   if we are not o
0830: 70 65 72 61 74 69 6e 67 20 66 72 6f 6d 20 43 47  perating from CG
0840: 49 2c 20 73 69 6e 63 65 20 2a 2f 0a 2f 2a 20 53  I, since */./* S
0850: 65 61 72 63 68 20 69 73 20 61 63 63 6f 6d 70 6c  earch is accompl
0860: 69 73 68 65 64 20 75 73 69 6e 67 20 43 47 49 20  ished using CGI 
0870: 61 6e 64 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72  and will not wor
0880: 6b 20 77 69 74 68 6f 75 74 20 69 74 2e 20 2a 2f  k without it. */
0890: 0a 69 66 28 20 21 6c 6f 63 61 74 69 6f 6e 2e 6f  .if( !location.o
08a0: 72 69 67 69 6e 2e 6d 61 74 63 68 20 7c 7c 20 21  rigin.match || !
08b0: 6c 6f 63 61 74 69 6f 6e 2e 6f 72 69 67 69 6e 2e  location.origin.
08c0: 6d 61 74 63 68 28 2f 68 74 74 70 2f 29 20 29 7b  match(/http/) ){
08d0: 0a 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c 65  .document.getEle
08e0: 6d 65 6e 74 42 79 49 64 28 22 73 65 61 72 63 68  mentById("search
08f0: 5f 6d 65 6e 75 62 75 74 74 6f 6e 22 29 2e 73 74  _menubutton").st
0900: 79 6c 65 2e 64 69 73 70 6c 61 79 20 3d 20 22 6e  yle.display = "n
0910: 6f 6e 65 22 3b 0a 7d 0a 2f 2a 20 55 73 65 64 20  one";.}./* Used 
0920: 62 79 20 74 68 65 20 48 69 64 65 2f 53 68 6f 77  by the Hide/Show
0930: 20 62 75 74 74 6f 6e 20 62 65 73 69 64 65 20 73   button beside s
0940: 79 6e 74 61 78 20 64 69 61 67 72 61 6d 73 2c 20  yntax diagrams, 
0950: 74 6f 20 74 6f 67 67 6c 65 20 74 68 65 20 2a 2f  to toggle the */
0960: 0a 66 75 6e 63 74 69 6f 6e 20 68 69 64 65 6f 72  .function hideor
0970: 73 68 6f 77 28 62 74 6e 2c 6f 62 6a 29 7b 0a 76  show(btn,obj){.v
0980: 61 72 20 78 20 3d 20 64 6f 63 75 6d 65 6e 74 2e  ar x = document.
0990: 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64 28 6f  getElementById(o
09a0: 62 6a 29 3b 0a 76 61 72 20 62 20 3d 20 64 6f 63  bj);.var b = doc
09b0: 75 6d 65 6e 74 2e 67 65 74 45 6c 65 6d 65 6e 74  ument.getElement
09c0: 42 79 49 64 28 62 74 6e 29 3b 0a 69 66 28 20 78  ById(btn);.if( x
09d0: 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79 21 3d  .style.display!=
09e0: 27 6e 6f 6e 65 27 20 29 7b 0a 78 2e 73 74 79 6c  'none' ){.x.styl
09f0: 65 2e 64 69 73 70 6c 61 79 20 3d 20 27 6e 6f 6e  e.display = 'non
0a00: 65 27 3b 0a 62 2e 69 6e 6e 65 72 48 54 4d 4c 3d  e';.b.innerHTML=
0a10: 27 73 68 6f 77 27 3b 0a 7d 65 6c 73 65 7b 0a 78  'show';.}else{.x
0a20: 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79 20 3d  .style.display =
0a30: 20 27 27 3b 0a 62 2e 69 6e 6e 65 72 48 54 4d 4c   '';.b.innerHTML
0a40: 3d 27 68 69 64 65 27 3b 0a 7d 0a 72 65 74 75 72  ='hide';.}.retur
0a50: 6e 20 66 61 6c 73 65 3b 0a 7d 0a 3c 2f 73 63 72  n false;.}.</scr
0a60: 69 70 74 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76  ipt>.</div>.<div
0a70: 20 63 6c 61 73 73 3d 6e 6f 73 65 61 72 63 68 3e   class=nosearch>
0a80: 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 65  <h1 align="cente
0a90: 72 22 3e 53 51 4c 20 41 73 20 55 6e 64 65 72 73  r">SQL As Unders
0aa0: 74 6f 6f 64 20 42 79 20 53 51 4c 69 74 65 3c 2f  tood By SQLite</
0ab0: 68 31 3e 3c 70 3e 3c 61 20 68 72 65 66 3d 22 6c  h1><p><a href="l
0ac0: 61 6e 67 2e 68 74 6d 6c 22 3e 5b 54 6f 70 5d 3c  ang.html">[Top]<
0ad0: 2f 61 3e 3c 2f 70 3e 3c 68 32 3e 44 61 74 65 20  /a></p><h2>Date 
0ae0: 41 6e 64 20 54 69 6d 65 20 46 75 6e 63 74 69 6f  And Time Functio
0af0: 6e 73 3c 2f 68 32 3e 3c 2f 64 69 76 3e 0a 0a 3c  ns</h2></div>..<
0b00: 70 3e 0a 53 51 4c 69 74 65 20 73 75 70 70 6f 72  p>.SQLite suppor
0b10: 74 73 20 66 69 76 65 20 64 61 74 65 20 61 6e 64  ts five date and
0b20: 20 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e 73 20   time functions 
0b30: 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 3c 2f 70 3e  as follows:.</p>
0b40: 0a 0a 3c 70 3e 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 20  ..<p>.<ol>.<li> 
0b50: 3c 62 3e 64 61 74 65 28 3c 2f 62 3e 3c 69 3e 74  <b>date(</b><i>t
0b60: 69 6d 65 73 74 72 69 6e 67 2c 20 6d 6f 64 69 66  imestring, modif
0b70: 69 65 72 2c 20 6d 6f 64 69 66 69 65 72 2c 20 2e  ier, modifier, .
0b80: 2e 2e 3c 2f 69 3e 3c 62 3e 29 3c 2f 62 3e 20 3c  ..</i><b>)</b> <
0b90: 2f 6c 69 3e 0a 3c 6c 69 3e 20 3c 62 3e 74 69 6d  /li>.<li> <b>tim
0ba0: 65 28 3c 2f 62 3e 3c 69 3e 74 69 6d 65 73 74 72  e(</b><i>timestr
0bb0: 69 6e 67 2c 20 6d 6f 64 69 66 69 65 72 2c 20 6d  ing, modifier, m
0bc0: 6f 64 69 66 69 65 72 2c 20 2e 2e 2e 3c 2f 69 3e  odifier, ...</i>
0bd0: 3c 62 3e 29 3c 2f 62 3e 20 3c 2f 6c 69 3e 0a 3c  <b>)</b> </li>.<
0be0: 6c 69 3e 20 3c 62 3e 64 61 74 65 74 69 6d 65 28  li> <b>datetime(
0bf0: 3c 2f 62 3e 3c 69 3e 74 69 6d 65 73 74 72 69 6e  </b><i>timestrin
0c00: 67 2c 20 6d 6f 64 69 66 69 65 72 2c 20 6d 6f 64  g, modifier, mod
0c10: 69 66 69 65 72 2c 20 2e 2e 2e 3c 2f 69 3e 3c 62  ifier, ...</i><b
0c20: 3e 29 3c 2f 62 3e 20 3c 2f 6c 69 3e 0a 3c 6c 69  >)</b> </li>.<li
0c30: 3e 20 3c 62 3e 6a 75 6c 69 61 6e 64 61 79 28 3c  > <b>julianday(<
0c40: 2f 62 3e 3c 69 3e 74 69 6d 65 73 74 72 69 6e 67  /b><i>timestring
0c50: 2c 20 6d 6f 64 69 66 69 65 72 2c 20 6d 6f 64 69  , modifier, modi
0c60: 66 69 65 72 2c 20 2e 2e 2e 3c 2f 69 3e 3c 62 3e  fier, ...</i><b>
0c70: 29 3c 2f 62 3e 20 3c 2f 6c 69 3e 0a 3c 6c 69 3e  )</b> </li>.<li>
0c80: 20 3c 62 3e 73 74 72 66 74 69 6d 65 28 3c 2f 62   <b>strftime(</b
0c90: 3e 3c 69 3e 66 6f 72 6d 61 74 2c 20 74 69 6d 65  ><i>format, time
0ca0: 73 74 72 69 6e 67 2c 20 6d 6f 64 69 66 69 65 72  string, modifier
0cb0: 2c 20 6d 6f 64 69 66 69 65 72 2c 20 2e 2e 2e 3c  , modifier, ...<
0cc0: 2f 69 3e 3c 62 3e 29 3c 2f 62 3e 20 3c 2f 6c 69  /i><b>)</b> </li
0cd0: 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 0a 41 6c 6c  >.</ol>..<p>.All
0ce0: 20 66 69 76 65 20 64 61 74 65 20 61 6e 64 20 74   five date and t
0cf0: 69 6d 65 20 66 75 6e 63 74 69 6f 6e 73 20 74 61  ime functions ta
0d00: 6b 65 20 61 20 74 69 6d 65 20 73 74 72 69 6e 67  ke a time string
0d10: 20 61 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 2e   as an argument.
0d20: 20 0a 54 68 65 20 74 69 6d 65 20 73 74 72 69 6e   .The time strin
0d30: 67 20 69 73 20 66 6f 6c 6c 6f 77 65 64 20 62 79  g is followed by
0d40: 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 6d 6f   zero or more mo
0d50: 64 69 66 69 65 72 73 2e 20 0a 54 68 65 20 73 74  difiers. .The st
0d60: 72 66 74 69 6d 65 28 29 20 66 75 6e 63 74 69 6f  rftime() functio
0d70: 6e 20 61 6c 73 6f 20 74 61 6b 65 73 20 61 20 66  n also takes a f
0d80: 6f 72 6d 61 74 20 73 74 72 69 6e 67 20 61 73 20  ormat string as 
0d90: 69 74 73 20 66 69 72 73 74 20 61 72 67 75 6d 65  its first argume
0da0: 6e 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68  nt..</p>..<p>.Th
0db0: 65 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65 20  e date and time 
0dc0: 66 75 6e 63 74 69 6f 6e 73 20 75 73 65 20 61 20  functions use a 
0dd0: 73 75 62 73 65 74 20 6f 66 0a 3c 61 20 68 72 65  subset of.<a hre
0de0: 66 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b  f="http://en.wik
0df0: 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f  ipedia.org/wiki/
0e00: 49 53 4f 5f 38 36 30 31 22 3e 49 53 30 2d 38 36  ISO_8601">IS0-86
0e10: 30 31 3c 2f 61 3e 20 64 61 74 65 20 61 6e 64 20  01</a> date and 
0e20: 74 69 6d 65 0a 66 6f 72 6d 61 74 73 2e 0a 54 68  time.formats..Th
0e30: 65 20 64 61 74 65 28 29 20 66 75 6e 63 74 69 6f  e date() functio
0e40: 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 64 61  n returns the da
0e50: 74 65 20 69 6e 20 74 68 69 73 20 66 6f 72 6d 61  te in this forma
0e60: 74 3a 20 59 59 59 59 2d 4d 4d 2d 44 44 2e 20 0a  t: YYYY-MM-DD. .
0e70: 54 68 65 20 74 69 6d 65 28 29 20 66 75 6e 63 74  The time() funct
0e80: 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20  ion returns the 
0e90: 74 69 6d 65 20 61 73 20 48 48 3a 4d 4d 3a 53 53  time as HH:MM:SS
0ea0: 2e 20 0a 54 68 65 20 64 61 74 65 74 69 6d 65 28  . .The datetime(
0eb0: 29 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72  ) function retur
0ec0: 6e 73 20 22 59 59 59 59 2d 4d 4d 2d 44 44 20 48  ns "YYYY-MM-DD H
0ed0: 48 3a 4d 4d 3a 53 53 22 2e 20 0a 54 68 65 20 6a  H:MM:SS". .The j
0ee0: 75 6c 69 61 6e 64 61 79 28 29 20 66 75 6e 63 74  ulianday() funct
0ef0: 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20  ion returns the 
0f00: 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f  .<a href="http:/
0f10: 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f 72  /en.wikipedia.or
0f20: 67 2f 77 69 6b 69 2f 4a 75 6c 69 61 6e 5f 64 61  g/wiki/Julian_da
0f30: 79 22 3e 4a 75 6c 69 61 6e 20 64 61 79 3c 2f 61  y">Julian day</a
0f40: 3e 20 2d 20 74 68 65 0a 6e 75 6d 62 65 72 20 6f  > - the.number o
0f50: 66 20 64 61 79 73 20 73 69 6e 63 65 20 6e 6f 6f  f days since noo
0f60: 6e 20 69 6e 20 47 72 65 65 6e 77 69 63 68 20 6f  n in Greenwich o
0f70: 6e 20 4e 6f 76 65 6d 62 65 72 20 32 34 2c 20 34  n November 24, 4
0f80: 37 31 34 20 42 2e 43 2e 20 0a 28 3c 61 20 68 72  714 B.C. .(<a hr
0f90: 65 66 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e 77 69  ef="http://en.wi
0fa0: 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69  kipedia.org/wiki
0fb0: 2f 50 72 6f 6c 65 70 74 69 63 5f 47 72 65 67 6f  /Proleptic_Grego
0fc0: 72 69 61 6e 5f 63 61 6c 65 6e 64 61 72 22 3e 50  rian_calendar">P
0fd0: 72 6f 6c 65 70 74 69 63 20 47 72 65 67 6f 72 69  roleptic Gregori
0fe0: 61 6e 20 63 61 6c 65 6e 64 61 72 3c 2f 61 3e 29  an calendar</a>)
0ff0: 2e 0a 54 68 65 20 73 74 72 66 74 69 6d 65 28 29  ..The strftime()
1000: 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 6e 73   routine returns
1010: 20 74 68 65 20 64 61 74 65 20 66 6f 72 6d 61 74   the date format
1020: 74 65 64 20 61 63 63 6f 72 64 69 6e 67 20 74 6f  ted according to
1030: 20 0a 74 68 65 20 66 6f 72 6d 61 74 20 73 74 72   .the format str
1040: 69 6e 67 20 73 70 65 63 69 66 69 65 64 20 61 73  ing specified as
1050: 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75 6d   the first argum
1060: 65 6e 74 2e 0a 54 68 65 20 66 6f 72 6d 61 74 20  ent..The format 
1070: 73 74 72 69 6e 67 20 73 75 70 70 6f 72 74 73 20  string supports 
1080: 74 68 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f 6e 20  the most common 
1090: 73 75 62 73 74 69 74 75 74 69 6f 6e 73 20 66 6f  substitutions fo
10a0: 75 6e 64 20 69 6e 20 74 68 65 20 0a 3c 61 20 68  und in the .<a h
10b0: 72 65 66 3d 22 68 74 74 70 3a 2f 2f 6f 70 65 6e  ref="http://open
10c0: 67 72 6f 75 70 2e 6f 72 67 2f 6f 6e 6c 69 6e 65  group.org/online
10d0: 70 75 62 73 2f 30 30 37 39 30 38 37 39 39 2f 78  pubs/007908799/x
10e0: 73 68 2f 73 74 72 66 74 69 6d 65 2e 68 74 6d 6c  sh/strftime.html
10f0: 22 3e 73 74 72 66 74 69 6d 65 28 29 20 66 75 6e  ">strftime() fun
1100: 63 74 69 6f 6e 3c 2f 61 3e 0a 66 72 6f 6d 20 74  ction</a>.from t
1110: 68 65 20 73 74 61 6e 64 61 72 64 20 43 20 6c 69  he standard C li
1120: 62 72 61 72 79 20 70 6c 75 73 20 74 77 6f 20 6e  brary plus two n
1130: 65 77 20 73 75 62 73 74 69 74 75 74 69 6f 6e 73  ew substitutions
1140: 2c 20 25 66 20 61 6e 64 20 25 4a 2e 0a 54 68 65  , %f and %J..The
1150: 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 20 61 20   following is a 
1160: 63 6f 6d 70 6c 65 74 65 20 6c 69 73 74 20 6f 66  complete list of
1170: 20 76 61 6c 69 64 20 73 74 72 66 74 69 6d 65 28   valid strftime(
1180: 29 20 73 75 62 73 74 69 74 75 74 69 6f 6e 73 3a  ) substitutions:
1190: 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f  .</p>..<blockquo
11a0: 74 65 3e 0a 3c 74 61 62 6c 65 20 62 6f 72 64 65  te>.<table borde
11b0: 72 3d 22 30 22 20 63 65 6c 6c 70 61 64 64 69 6e  r="0" cellpaddin
11c0: 67 3d 22 30 22 20 63 65 6c 6c 73 70 61 63 69 6e  g="0" cellspacin
11d0: 67 3d 22 30 22 3e 0a 3c 74 72 3e 3c 74 64 3e 3c  g="0">.<tr><td><
11e0: 74 64 20 77 69 64 74 68 3d 22 31 30 22 3e 3c 74  td width="10"><t
11f0: 64 3e 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 3c 74 64  d></tr>..<tr><td
1200: 3e 20 25 64 20 3c 74 64 3e 3c 74 64 3e 20 64 61  > %d <td><td> da
1210: 79 20 6f 66 20 6d 6f 6e 74 68 3a 20 30 30 0a 3c  y of month: 00.<
1220: 74 72 3e 3c 74 64 3e 20 25 66 20 3c 74 64 3e 3c  tr><td> %f <td><
1230: 74 64 3e 20 66 72 61 63 74 69 6f 6e 61 6c 20 73  td> fractional s
1240: 65 63 6f 6e 64 73 3a 20 53 53 2e 53 53 53 0a 3c  econds: SS.SSS.<
1250: 74 72 3e 3c 74 64 3e 20 25 48 20 3c 74 64 3e 3c  tr><td> %H <td><
1260: 74 64 3e 20 68 6f 75 72 3a 20 30 30 2d 32 34 20  td> hour: 00-24 
1270: 0a 3c 74 72 3e 3c 74 64 3e 20 25 6a 20 3c 74 64  .<tr><td> %j <td
1280: 3e 3c 74 64 3e 20 64 61 79 20 6f 66 20 79 65 61  ><td> day of yea
1290: 72 3a 20 30 30 31 2d 33 36 36 0a 3c 74 72 3e 3c  r: 001-366.<tr><
12a0: 74 64 3e 20 25 4a 20 3c 74 64 3e 3c 74 64 3e 20  td> %J <td><td> 
12b0: 4a 75 6c 69 61 6e 20 64 61 79 20 6e 75 6d 62 65  Julian day numbe
12c0: 72 0a 3c 74 72 3e 3c 74 64 3e 20 25 6d 20 3c 74  r.<tr><td> %m <t
12d0: 64 3e 3c 74 64 3e 20 6d 6f 6e 74 68 3a 20 30 31  d><td> month: 01
12e0: 2d 31 32 0a 3c 74 72 3e 3c 74 64 3e 20 25 4d 20  -12.<tr><td> %M 
12f0: 3c 74 64 3e 3c 74 64 3e 20 6d 69 6e 75 74 65 3a  <td><td> minute:
1300: 20 30 30 2d 35 39 0a 3c 74 72 3e 3c 74 64 3e 20   00-59.<tr><td> 
1310: 25 73 20 3c 74 64 3e 3c 74 64 3e 20 73 65 63 6f  %s <td><td> seco
1320: 6e 64 73 20 73 69 6e 63 65 20 31 39 37 30 2d 30  nds since 1970-0
1330: 31 2d 30 31 0a 3c 74 72 3e 3c 74 64 3e 20 25 53  1-01.<tr><td> %S
1340: 20 3c 74 64 3e 3c 74 64 3e 20 73 65 63 6f 6e 64   <td><td> second
1350: 73 3a 20 30 30 2d 35 39 0a 3c 74 72 3e 3c 74 64  s: 00-59.<tr><td
1360: 3e 20 25 77 20 3c 74 64 3e 3c 74 64 3e 20 64 61  > %w <td><td> da
1370: 79 20 6f 66 20 77 65 65 6b 20 30 2d 36 20 77 69  y of week 0-6 wi
1380: 74 68 20 53 75 6e 64 61 79 3d 3d 30 0a 3c 74 72  th Sunday==0.<tr
1390: 3e 3c 74 64 3e 20 25 57 20 3c 74 64 3e 3c 74 64  ><td> %W <td><td
13a0: 3e 20 77 65 65 6b 20 6f 66 20 79 65 61 72 3a 20  > week of year: 
13b0: 30 30 2d 35 33 0a 3c 74 72 3e 3c 74 64 3e 20 25  00-53.<tr><td> %
13c0: 59 20 3c 74 64 3e 3c 74 64 3e 20 79 65 61 72 3a  Y <td><td> year:
13d0: 20 30 30 30 30 2d 39 39 39 39 0a 3c 74 72 3e 3c   0000-9999.<tr><
13e0: 74 64 3e 20 25 25 20 3c 74 64 3e 3c 74 64 3e 20  td> %% <td><td> 
13f0: 25 0a 3c 2f 74 61 62 6c 65 3e 0a 3c 2f 62 6c 6f  %.</table>.</blo
1400: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 4e 6f  ckquote>..<p>.No
1410: 74 69 63 65 20 74 68 61 74 20 61 6c 6c 20 6f 74  tice that all ot
1420: 68 65 72 20 64 61 74 65 20 61 6e 64 20 74 69 6d  her date and tim
1430: 65 20 66 75 6e 63 74 69 6f 6e 73 20 63 61 6e 20  e functions can 
1440: 62 65 20 65 78 70 72 65 73 73 65 64 0a 69 6e 20  be expressed.in 
1450: 74 65 72 6d 73 20 6f 66 20 73 74 72 66 74 69 6d  terms of strftim
1460: 65 28 29 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63  e():.</p>..<bloc
1470: 6b 71 75 6f 74 65 3e 0a 3c 74 61 62 6c 65 20 62  kquote>.<table b
1480: 6f 72 64 65 72 3d 22 30 22 20 63 65 6c 6c 70 61  order="0" cellpa
1490: 64 64 69 6e 67 3d 22 30 22 20 63 65 6c 6c 73 70  dding="0" cellsp
14a0: 61 63 69 6e 67 3d 22 30 22 3e 0a 3c 74 72 3e 3c  acing="0">.<tr><
14b0: 74 64 3e 3c 62 3e 46 75 6e 63 74 69 6f 6e 3c 2f  td><b>Function</
14c0: 62 3e 3c 74 64 20 77 69 64 74 68 3d 22 33 30 22  b><td width="30"
14d0: 3e 3c 74 64 3e 3c 62 3e 45 71 75 69 76 61 6c 65  ><td><b>Equivale
14e0: 6e 74 20 73 74 72 66 74 69 6d 65 28 29 3c 2f 62  nt strftime()</b
14f0: 3e 0a 3c 74 72 3e 3c 74 64 3e 20 20 20 64 61 74  >.<tr><td>   dat
1500: 65 28 2e 2e 2e 29 20 20 20 20 20 20 3c 74 64 3e  e(...)      <td>
1510: 3c 74 64 3e 20 20 73 74 72 66 74 69 6d 65 28 27  <td>  strftime('
1520: 25 59 2d 25 6d 2d 25 64 27 2c 20 2e 2e 2e 29 0a  %Y-%m-%d', ...).
1530: 3c 74 72 3e 3c 74 64 3e 20 20 20 74 69 6d 65 28  <tr><td>   time(
1540: 2e 2e 2e 29 20 20 20 20 20 20 3c 74 64 3e 3c 74  ...)      <td><t
1550: 64 3e 20 20 73 74 72 66 74 69 6d 65 28 27 25 48  d>  strftime('%H
1560: 3a 25 4d 3a 25 53 27 2c 20 2e 2e 2e 29 0a 3c 74  :%M:%S', ...).<t
1570: 72 3e 3c 74 64 3e 20 20 20 64 61 74 65 74 69 6d  r><td>   datetim
1580: 65 28 2e 2e 2e 29 20 20 3c 74 64 3e 3c 74 64 3e  e(...)  <td><td>
1590: 20 20 73 74 72 66 74 69 6d 65 28 27 25 59 2d 25    strftime('%Y-%
15a0: 6d 2d 25 64 20 25 48 3a 25 4d 3a 25 53 27 2c 20  m-%d %H:%M:%S', 
15b0: 2e 2e 2e 29 0a 3c 74 72 3e 3c 74 64 3e 20 20 20  ...).<tr><td>   
15c0: 6a 75 6c 69 61 6e 64 61 79 28 2e 2e 2e 29 20 3c  julianday(...) <
15d0: 74 64 3e 3c 74 64 3e 20 20 73 74 72 66 74 69 6d  td><td>  strftim
15e0: 65 28 27 25 4a 27 2c 20 2e 2e 2e 29 0a 3c 2f 74  e('%J', ...).</t
15f0: 61 62 6c 65 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f  able>.</blockquo
1600: 74 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 6f 6e 6c  te>..<p>.The onl
1610: 79 20 72 65 61 73 6f 6e 73 20 66 6f 72 20 70 72  y reasons for pr
1620: 6f 76 69 64 69 6e 67 20 66 75 6e 63 74 69 6f 6e  oviding function
1630: 73 20 6f 74 68 65 72 20 74 68 61 6e 20 73 74 72  s other than str
1640: 66 74 69 6d 65 28 29 20 69 73 0a 66 6f 72 20 63  ftime() is.for c
1650: 6f 6e 76 65 6e 69 65 6e 63 65 20 61 6e 64 20 66  onvenience and f
1660: 6f 72 20 65 66 66 69 63 69 65 6e 63 79 2e 0a 3c  or efficiency..<
1670: 2f 70 3e 0a 0a 3c 68 33 3e 54 69 6d 65 20 53 74  /p>..<h3>Time St
1680: 72 69 6e 67 73 3c 2f 68 33 3e 0a 0a 3c 70 3e 41  rings</h3>..<p>A
1690: 20 74 69 6d 65 20 73 74 72 69 6e 67 20 63 61 6e   time string can
16a0: 20 62 65 20 69 6e 20 61 6e 79 20 6f 66 20 74 68   be in any of th
16b0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6f 72 6d  e following form
16c0: 61 74 73 3a 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c  ats:</p>..<ol>.<
16d0: 6c 69 3e 20 3c 69 3e 59 59 59 59 2d 4d 4d 2d 44  li> <i>YYYY-MM-D
16e0: 44 3c 2f 69 3e 0a 3c 6c 69 3e 20 3c 69 3e 59 59  D</i>.<li> <i>YY
16f0: 59 59 2d 4d 4d 2d 44 44 20 48 48 3a 4d 4d 3c 2f  YY-MM-DD HH:MM</
1700: 69 3e 0a 3c 6c 69 3e 20 3c 69 3e 59 59 59 59 2d  i>.<li> <i>YYYY-
1710: 4d 4d 2d 44 44 20 48 48 3a 4d 4d 3a 53 53 3c 2f  MM-DD HH:MM:SS</
1720: 69 3e 0a 3c 6c 69 3e 20 3c 69 3e 59 59 59 59 2d  i>.<li> <i>YYYY-
1730: 4d 4d 2d 44 44 20 48 48 3a 4d 4d 3a 53 53 2e 53  MM-DD HH:MM:SS.S
1740: 53 53 3c 2f 69 3e 0a 3c 6c 69 3e 20 3c 69 3e 59  SS</i>.<li> <i>Y
1750: 59 59 59 2d 4d 4d 2d 44 44 3c 2f 69 3e 3c 62 3e  YYY-MM-DD</i><b>
1760: 54 3c 2f 62 3e 3c 69 3e 48 48 3a 4d 4d 3c 2f 69  T</b><i>HH:MM</i
1770: 3e 0a 3c 6c 69 3e 20 3c 69 3e 59 59 59 59 2d 4d  >.<li> <i>YYYY-M
1780: 4d 2d 44 44 3c 2f 69 3e 3c 62 3e 54 3c 2f 62 3e  M-DD</i><b>T</b>
1790: 3c 69 3e 48 48 3a 4d 4d 3a 53 53 3c 2f 69 3e 0a  <i>HH:MM:SS</i>.
17a0: 3c 6c 69 3e 20 3c 69 3e 59 59 59 59 2d 4d 4d 2d  <li> <i>YYYY-MM-
17b0: 44 44 3c 2f 69 3e 3c 62 3e 54 3c 2f 62 3e 3c 69  DD</i><b>T</b><i
17c0: 3e 48 48 3a 4d 4d 3a 53 53 2e 53 53 53 3c 2f 69  >HH:MM:SS.SSS</i
17d0: 3e 0a 3c 6c 69 3e 20 3c 69 3e 48 48 3a 4d 4d 3c  >.<li> <i>HH:MM<
17e0: 2f 69 3e 0a 3c 6c 69 3e 20 3c 69 3e 48 48 3a 4d  /i>.<li> <i>HH:M
17f0: 4d 3a 53 53 3c 2f 69 3e 0a 3c 6c 69 3e 20 3c 69  M:SS</i>.<li> <i
1800: 3e 48 48 3a 4d 4d 3a 53 53 2e 53 53 53 3c 2f 69  >HH:MM:SS.SSS</i
1810: 3e 0a 3c 6c 69 3e 20 3c 62 3e 6e 6f 77 3c 2f 62  >.<li> <b>now</b
1820: 3e 0a 3c 6c 69 3e 20 3c 69 3e 44 44 44 44 44 44  >.<li> <i>DDDDDD
1830: 44 44 44 44 3c 2f 69 3e 0a 3c 2f 6f 6c 3e 0a 0a  DDDD</i>.</ol>..
1840: 3c 70 3e 0a 49 6e 20 66 6f 72 6d 61 74 73 20 35  <p>.In formats 5
1850: 20 74 68 72 6f 75 67 68 20 37 2c 20 74 68 65 20   through 7, the 
1860: 22 54 22 20 69 73 20 61 20 6c 69 74 65 72 61 6c  "T" is a literal
1870: 20 63 68 61 72 61 63 74 65 72 20 73 65 70 61 72   character separ
1880: 61 74 69 6e 67 20 0a 74 68 65 20 64 61 74 65 20  ating .the date 
1890: 61 6e 64 20 74 68 65 20 74 69 6d 65 2c 20 61 73  and the time, as
18a0: 20 72 65 71 75 69 72 65 64 20 62 79 20 0a 3c 61   required by .<a
18b0: 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77   href="http://ww
18c0: 77 2e 77 33 63 2e 6f 72 67 2f 54 52 2f 4e 4f 54  w.w3c.org/TR/NOT
18d0: 45 2d 64 61 74 65 74 69 6d 65 22 3e 49 53 4f 2d  E-datetime">ISO-
18e0: 38 36 30 31 3c 2f 61 3e 2e 20 0a 46 6f 72 6d 61  8601</a>. .Forma
18f0: 74 73 20 38 20 74 68 72 6f 75 67 68 20 31 30 20  ts 8 through 10 
1900: 74 68 61 74 20 73 70 65 63 69 66 79 20 6f 6e 6c  that specify onl
1910: 79 20 61 20 74 69 6d 65 20 61 73 73 75 6d 65 20  y a time assume 
1920: 61 20 64 61 74 65 20 6f 66 20 0a 32 30 30 30 2d  a date of .2000-
1930: 30 31 2d 30 31 2e 20 46 6f 72 6d 61 74 20 31 31  01-01. Format 11
1940: 2c 20 74 68 65 20 73 74 72 69 6e 67 20 27 6e 6f  , the string 'no
1950: 77 27 2c 20 69 73 20 63 6f 6e 76 65 72 74 65 64  w', is converted
1960: 20 69 6e 74 6f 20 74 68 65 20 0a 63 75 72 72 65   into the .curre
1970: 6e 74 20 64 61 74 65 20 61 6e 64 20 74 69 6d 65  nt date and time
1980: 20 61 73 20 6f 62 74 61 69 6e 65 64 20 66 72 6f   as obtained fro
1990: 6d 20 74 68 65 20 78 43 75 72 72 65 6e 74 54 69  m the xCurrentTi
19a0: 6d 65 20 6d 65 74 68 6f 64 0a 6f 66 20 74 68 65  me method.of the
19b0: 20 3c 61 20 68 72 65 66 3d 22 63 33 72 65 66 2f   <a href="c3ref/
19c0: 76 66 73 2e 68 74 6d 6c 22 3e 73 71 6c 69 74 65  vfs.html">sqlite
19d0: 33 5f 76 66 73 3c 2f 61 3e 20 6f 62 6a 65 63 74  3_vfs</a> object
19e0: 20 69 6e 20 75 73 65 2e 0a 54 68 65 20 27 6e 6f   in use..The 'no
19f0: 77 27 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 64  w' argument to d
1a00: 61 74 65 20 61 6e 64 20 74 69 6d 65 20 66 75 6e  ate and time fun
1a10: 63 74 69 6f 6e 73 20 61 6c 77 61 79 73 20 72 65  ctions always re
1a20: 74 75 72 6e 73 20 65 78 61 63 74 6c 79 20 74 68  turns exactly th
1a30: 65 0a 73 61 6d 65 20 76 61 6c 75 65 20 66 6f 72  e.same value for
1a40: 20 6d 75 6c 74 69 70 6c 65 20 69 6e 76 6f 63 61   multiple invoca
1a50: 74 69 6f 6e 73 20 77 69 74 68 69 6e 20 74 68 65  tions within the
1a60: 20 73 61 6d 65 20 3c 61 20 68 72 65 66 3d 22 63   same <a href="c
1a70: 33 72 65 66 2f 73 74 65 70 2e 68 74 6d 6c 22 3e  3ref/step.html">
1a80: 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 3c 2f  sqlite3_step()</
1a90: 61 3e 20 63 61 6c 6c 2e 0a 3c 61 20 68 72 65 66  a> call..<a href
1aa0: 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69  ="http://en.wiki
1ab0: 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 43  pedia.org/wiki/C
1ac0: 6f 6f 72 64 69 6e 61 74 65 64 5f 55 6e 69 76 65  oordinated_Unive
1ad0: 72 73 61 6c 5f 54 69 6d 65 22 3e 55 6e 69 76 65  rsal_Time">Unive
1ae0: 72 73 61 6c 20 43 6f 6f 72 64 69 6e 61 74 65 64  rsal Coordinated
1af0: 20 54 69 6d 65 20 28 55 54 43 29 3c 2f 61 3e 20   Time (UTC)</a> 
1b00: 69 73 20 75 73 65 64 2e 20 0a 46 6f 72 6d 61 74  is used. .Format
1b10: 20 31 32 20 69 73 20 74 68 65 20 0a 3c 61 20 68   12 is the .<a h
1b20: 72 65 66 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e 77  ref="http://en.w
1b30: 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b  ikipedia.org/wik
1b40: 69 2f 4a 75 6c 69 61 6e 5f 64 61 79 22 3e 4a 75  i/Julian_day">Ju
1b50: 6c 69 61 6e 20 64 61 79 20 6e 75 6d 62 65 72 3c  lian day number<
1b60: 2f 61 3e 0a 65 78 70 72 65 73 73 65 64 20 61 73  /a>.expressed as
1b70: 20 61 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e   a floating poin
1b80: 74 20 76 61 6c 75 65 2e 0a 3c 2f 70 3e 0a 0a 3c  t value..</p>..<
1b90: 70 3e 0a 46 6f 72 6d 61 74 73 20 32 20 74 68 72  p>.Formats 2 thr
1ba0: 6f 75 67 68 20 31 30 20 6d 61 79 20 62 65 20 6f  ough 10 may be o
1bb0: 70 74 69 6f 6e 61 6c 6c 79 20 66 6f 6c 6c 6f 77  ptionally follow
1bc0: 65 64 20 62 79 20 61 20 74 69 6d 65 7a 6f 6e 65  ed by a timezone
1bd0: 20 69 6e 64 69 63 61 74 6f 72 20 6f 66 20 74 68   indicator of th
1be0: 65 20 66 6f 72 6d 0a 22 3c 69 3e 26 23 39 31 3b  e form."<i>&#91;
1bf0: 2b 2d 26 23 39 33 3b 48 48 3a 4d 4d 3c 2f 69 3e  +-&#93;HH:MM</i>
1c00: 22 20 6f 72 20 6a 75 73 74 20 22 3c 69 3e 5a 3c  " or just "<i>Z<
1c10: 2f 69 3e 22 2e 20 20 54 68 65 20 64 61 74 65 20  /i>".  The date 
1c20: 61 6e 64 20 74 69 6d 65 20 66 75 6e 63 74 69 6f  and time functio
1c30: 6e 73 20 75 73 65 20 55 54 43 20 6f 72 20 22 7a  ns use UTC or "z
1c40: 75 6c 75 22 0a 74 69 6d 65 20 69 6e 74 65 72 6e  ulu".time intern
1c50: 61 6c 6c 79 2c 20 61 6e 64 20 73 6f 20 74 68 65  ally, and so the
1c60: 20 22 5a 22 20 73 75 66 66 69 78 20 69 73 20 61   "Z" suffix is a
1c70: 20 6e 6f 2d 6f 70 2e 20 20 41 6e 79 20 6e 6f 6e   no-op.  Any non
1c80: 2d 7a 65 72 6f 20 22 48 48 3a 4d 4d 22 20 73 75  -zero "HH:MM" su
1c90: 66 66 69 78 20 69 73 0a 73 75 62 74 72 61 63 74  ffix is.subtract
1ca0: 65 64 20 66 72 6f 6d 20 74 68 65 20 69 6e 64 69  ed from the indi
1cb0: 63 61 74 65 64 20 64 61 74 65 20 61 6e 64 20 74  cated date and t
1cc0: 69 6d 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20  ime in order to 
1cd0: 63 6f 6d 70 75 74 65 20 7a 75 6c 75 20 74 69 6d  compute zulu tim
1ce0: 65 2e 0a 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20  e..For example, 
1cf0: 61 6c 6c 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f  all of the follo
1d00: 77 69 6e 67 20 74 69 6d 65 20 73 74 72 69 6e 67  wing time string
1d10: 73 20 61 72 65 20 65 71 75 69 76 61 6c 65 6e 74  s are equivalent
1d20: 3a 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75  :.</p>..<blockqu
1d30: 6f 74 65 3e 0a 32 30 31 33 2d 31 30 2d 30 37 20  ote>.2013-10-07 
1d40: 30 38 3a 32 33 3a 31 39 2e 31 32 30 3c 62 72 3e  08:23:19.120<br>
1d50: 0a 32 30 31 33 2d 31 30 2d 30 37 54 30 38 3a 32  .2013-10-07T08:2
1d60: 33 3a 31 39 2e 31 32 30 5a 3c 62 72 3e 0a 32 30  3:19.120Z<br>.20
1d70: 31 33 2d 31 30 2d 30 37 20 30 34 3a 32 33 3a 31  13-10-07 04:23:1
1d80: 39 2e 31 32 30 2d 30 34 3a 30 30 3c 62 72 3e 0a  9.120-04:00<br>.
1d90: 32 34 35 36 35 37 32 2e 38 34 39 35 32 36 38 35  2456572.84952685
1da0: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a  .</blockquote>..
1db0: 3c 70 3e 0a 49 6e 20 66 6f 72 6d 61 74 73 20 34  <p>.In formats 4
1dc0: 2c 20 37 2c 20 61 6e 64 20 31 30 2c 20 74 68 65  , 7, and 10, the
1dd0: 20 66 72 61 63 74 69 6f 6e 61 6c 20 73 65 63 6f   fractional seco
1de0: 6e 64 73 20 76 61 6c 75 65 20 53 53 2e 53 53 53  nds value SS.SSS
1df0: 20 63 61 6e 20 68 61 76 65 0a 6f 6e 65 20 6f 72   can have.one or
1e00: 20 6d 6f 72 65 20 64 69 67 69 74 73 20 66 6f 6c   more digits fol
1e10: 6c 6f 77 69 6e 67 20 74 68 65 20 64 65 63 69 6d  lowing the decim
1e20: 61 6c 20 70 6f 69 6e 74 2e 20 20 45 78 61 63 74  al point.  Exact
1e30: 6c 79 20 74 68 72 65 65 20 64 69 67 69 74 73 20  ly three digits 
1e40: 61 72 65 0a 73 68 6f 77 6e 20 69 6e 20 74 68 65  are.shown in the
1e50: 20 65 78 61 6d 70 6c 65 73 20 62 65 63 61 75 73   examples becaus
1e60: 65 20 6f 6e 6c 79 20 74 68 65 20 66 69 72 73 74  e only the first
1e70: 20 74 68 72 65 65 20 64 69 67 69 74 73 20 61 72   three digits ar
1e80: 65 20 73 69 67 6e 69 66 69 63 61 6e 74 0a 74 6f  e significant.to
1e90: 20 74 68 65 20 72 65 73 75 6c 74 2c 20 62 75 74   the result, but
1ea0: 20 74 68 65 20 69 6e 70 75 74 20 73 74 72 69 6e   the input strin
1eb0: 67 20 63 61 6e 20 68 61 76 65 20 66 65 77 65 72  g can have fewer
1ec0: 20 6f 72 20 6d 6f 72 65 20 74 68 61 6e 20 74 68   or more than th
1ed0: 72 65 65 20 64 69 67 69 74 73 0a 61 6e 64 20 74  ree digits.and t
1ee0: 68 65 20 64 61 74 65 2f 74 69 6d 65 20 66 75 6e  he date/time fun
1ef0: 63 74 69 6f 6e 73 20 77 69 6c 6c 20 73 74 69 6c  ctions will stil
1f00: 6c 20 6f 70 65 72 61 74 65 20 63 6f 72 72 65 63  l operate correc
1f10: 74 6c 79 2e 0a 53 69 6d 69 6c 61 72 6c 79 2c 20  tly..Similarly, 
1f20: 66 6f 72 6d 61 74 20 31 32 20 69 73 20 73 68 6f  format 12 is sho
1f30: 77 6e 20 77 69 74 68 20 31 30 20 73 69 67 6e 69  wn with 10 signi
1f40: 66 69 63 61 6e 74 20 64 69 67 69 74 73 2c 20 62  ficant digits, b
1f50: 75 74 20 74 68 65 20 64 61 74 65 2f 74 69 6d 65  ut the date/time
1f60: 0a 66 75 6e 63 74 69 6f 6e 73 20 77 69 6c 6c 20  .functions will 
1f70: 72 65 61 6c 6c 79 20 61 63 63 65 70 74 20 61 73  really accept as
1f80: 20 6d 61 6e 79 20 6f 72 20 61 73 20 66 65 77 20   many or as few 
1f90: 64 69 67 69 74 73 20 61 73 20 61 72 65 20 6e 65  digits as are ne
1fa0: 63 65 73 73 61 72 79 20 74 6f 0a 72 65 70 72 65  cessary to.repre
1fb0: 73 65 6e 74 20 74 68 65 20 4a 75 6c 69 61 6e 20  sent the Julian 
1fc0: 64 61 79 20 6e 75 6d 62 65 72 2e 0a 3c 2f 70 3e  day number..</p>
1fd0: 0a 0a 3c 68 33 3e 4d 6f 64 69 66 69 65 72 73 3c  ..<h3>Modifiers<
1fe0: 2f 68 33 3e 0a 0a 3c 70 3e 54 68 65 20 74 69 6d  /h3>..<p>The tim
1ff0: 65 20 73 74 72 69 6e 67 20 63 61 6e 20 62 65 20  e string can be 
2000: 66 6f 6c 6c 6f 77 65 64 20 62 79 20 7a 65 72 6f  followed by zero
2010: 20 6f 72 20 6d 6f 72 65 20 6d 6f 64 69 66 69 65   or more modifie
2020: 72 73 20 74 68 61 74 20 0a 61 6c 74 65 72 20 64  rs that .alter d
2030: 61 74 65 20 61 6e 64 2f 6f 72 20 74 69 6d 65 2e  ate and/or time.
2040: 20 45 61 63 68 20 6d 6f 64 69 66 69 65 72 0a 69   Each modifier.i
2050: 73 20 61 20 74 72 61 6e 73 66 6f 72 6d 61 74 69  s a transformati
2060: 6f 6e 20 74 68 61 74 20 69 73 20 61 70 70 6c 69  on that is appli
2070: 65 64 20 74 6f 20 74 68 65 20 74 69 6d 65 20 76  ed to the time v
2080: 61 6c 75 65 20 74 6f 20 69 74 73 20 6c 65 66 74  alue to its left
2090: 2e 0a 4d 6f 64 69 66 69 65 72 73 20 61 72 65 20  ..Modifiers are 
20a0: 61 70 70 6c 69 65 64 20 66 72 6f 6d 20 6c 65 66  applied from lef
20b0: 74 20 74 6f 20 72 69 67 68 74 3b 20 6f 72 64 65  t to right; orde
20c0: 72 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 2e 0a  r is important..
20d0: 54 68 65 20 61 76 61 69 6c 61 62 6c 65 20 6d 6f  The available mo
20e0: 64 69 66 69 65 72 73 20 61 72 65 20 61 73 20 66  difiers are as f
20f0: 6f 6c 6c 6f 77 73 2e 3c 2f 70 3e 0a 0a 3c 6f 6c  ollows.</p>..<ol
2100: 3e 0a 3c 6c 69 3e 20 4e 4e 4e 20 64 61 79 73 0a  >.<li> NNN days.
2110: 3c 6c 69 3e 20 4e 4e 4e 20 68 6f 75 72 73 0a 3c  <li> NNN hours.<
2120: 6c 69 3e 20 4e 4e 4e 20 6d 69 6e 75 74 65 73 0a  li> NNN minutes.
2130: 3c 6c 69 3e 20 4e 4e 4e 2e 4e 4e 4e 4e 20 73 65  <li> NNN.NNNN se
2140: 63 6f 6e 64 73 0a 3c 6c 69 3e 20 4e 4e 4e 20 6d  conds.<li> NNN m
2150: 6f 6e 74 68 73 0a 3c 6c 69 3e 20 4e 4e 4e 20 79  onths.<li> NNN y
2160: 65 61 72 73 0a 3c 6c 69 3e 20 73 74 61 72 74 20  ears.<li> start 
2170: 6f 66 20 6d 6f 6e 74 68 0a 3c 6c 69 3e 20 73 74  of month.<li> st
2180: 61 72 74 20 6f 66 20 79 65 61 72 0a 3c 6c 69 3e  art of year.<li>
2190: 20 73 74 61 72 74 20 6f 66 20 64 61 79 0a 3c 6c   start of day.<l
21a0: 69 3e 20 77 65 65 6b 64 61 79 20 4e 0a 3c 6c 69  i> weekday N.<li
21b0: 3e 20 75 6e 69 78 65 70 6f 63 68 0a 3c 6c 69 3e  > unixepoch.<li>
21c0: 20 6c 6f 63 61 6c 74 69 6d 65 0a 3c 6c 69 3e 20   localtime.<li> 
21d0: 75 74 63 20 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 54  utc .</ol>..<p>T
21e0: 68 65 20 66 69 72 73 74 20 73 69 78 20 6d 6f 64  he first six mod
21f0: 69 66 69 65 72 73 20 28 31 20 74 68 72 6f 75 67  ifiers (1 throug
2200: 68 20 36 29 20 0a 73 69 6d 70 6c 79 20 61 64 64  h 6) .simply add
2210: 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 61   the specified a
2220: 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 20 74 6f  mount of time to
2230: 20 74 68 65 20 64 61 74 65 20 61 6e 64 20 74 69   the date and ti
2240: 6d 65 20 0a 73 70 65 63 69 66 69 65 64 20 62 79  me .specified by
2250: 20 74 68 65 20 70 72 65 63 65 64 69 6e 67 20 74   the preceding t
2260: 69 6d 65 73 74 72 69 6e 67 20 61 6e 64 20 6d 6f  imestring and mo
2270: 64 69 66 69 65 72 73 2e 0a 54 68 65 20 27 73 27  difiers..The 's'
2280: 20 63 68 61 72 61 63 74 65 72 20 61 74 20 74 68   character at th
2290: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 6f 64  e end of the mod
22a0: 69 66 69 65 72 20 6e 61 6d 65 73 20 69 73 20 6f  ifier names is o
22b0: 70 74 69 6f 6e 61 6c 2e 0a 4e 6f 74 65 20 74 68  ptional..Note th
22c0: 61 74 20 22 26 70 6c 75 73 6d 6e 3b 4e 4e 4e 20  at "&plusmn;NNN 
22d0: 6d 6f 6e 74 68 73 22 20 77 6f 72 6b 73 20 62 79  months" works by
22e0: 20 72 65 6e 64 65 72 69 6e 67 20 74 68 65 20 6f   rendering the o
22f0: 72 69 67 69 6e 61 6c 20 64 61 74 65 20 69 6e 74  riginal date int
2300: 6f 0a 74 68 65 20 59 59 59 59 2d 4d 4d 2d 44 44  o.the YYYY-MM-DD
2310: 20 66 6f 72 6d 61 74 2c 20 61 64 64 69 6e 67 20   format, adding 
2320: 74 68 65 20 26 70 6c 75 73 6d 6e 3b 4e 4e 4e 20  the &plusmn;NNN 
2330: 74 6f 20 74 68 65 20 4d 4d 20 6d 6f 6e 74 68 20  to the MM month 
2340: 76 61 6c 75 65 2c 20 74 68 65 6e 0a 6e 6f 72 6d  value, then.norm
2350: 61 6c 69 7a 69 6e 67 20 74 68 65 20 72 65 73 75  alizing the resu
2360: 6c 74 2e 20 20 54 68 75 73 2c 20 66 6f 72 20 65  lt.  Thus, for e
2370: 78 61 6d 70 6c 65 2c 20 74 68 65 20 64 61 74 61  xample, the data
2380: 20 32 30 30 31 2d 30 33 2d 33 31 20 6d 6f 64 69   2001-03-31 modi
2390: 66 69 65 64 0a 62 79 20 27 2b 31 20 6d 6f 6e 74  fied.by '+1 mont
23a0: 68 27 20 69 6e 69 74 69 61 6c 6c 79 20 79 69 65  h' initially yie
23b0: 6c 64 73 20 32 30 30 31 2d 30 34 2d 33 31 2c 20  lds 2001-04-31, 
23c0: 62 75 74 20 41 70 72 69 6c 20 6f 6e 6c 79 20 68  but April only h
23d0: 61 73 20 33 30 20 64 61 79 73 0a 73 6f 20 74 68  as 30 days.so th
23e0: 65 20 64 61 74 65 20 69 73 20 6e 6f 72 6d 61 6c  e date is normal
23f0: 69 7a 65 64 20 74 6f 20 32 30 30 31 2d 30 35 2d  ized to 2001-05-
2400: 30 31 2e 20 20 41 20 73 69 6d 69 6c 61 72 20 65  01.  A similar e
2410: 66 66 65 63 74 20 6f 63 63 75 72 73 20 77 68 65  ffect occurs whe
2420: 6e 0a 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 64  n.the original d
2430: 61 74 65 20 69 73 20 46 65 62 72 75 61 72 79 20  ate is February 
2440: 32 39 20 6f 66 20 61 20 6c 65 61 70 79 65 61 72  29 of a leapyear
2450: 20 61 6e 64 20 74 68 65 20 6d 6f 64 69 66 69 65   and the modifie
2460: 72 20 69 73 0a 26 70 6c 75 73 6d 6e 3b 4e 20 79  r is.&plusmn;N y
2470: 65 61 72 73 20 77 68 65 72 65 20 4e 20 69 73 20  ears where N is 
2480: 6e 6f 74 20 61 20 6d 75 6c 74 69 70 6c 65 20 6f  not a multiple o
2490: 66 20 66 6f 75 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e  f four.</p>..<p>
24a0: 54 68 65 20 22 73 74 61 72 74 20 6f 66 22 20 6d  The "start of" m
24b0: 6f 64 69 66 69 65 72 73 20 28 37 20 74 68 72 6f  odifiers (7 thro
24c0: 75 67 68 20 39 29 20 73 68 69 66 74 20 74 68 65  ugh 9) shift the
24d0: 20 64 61 74 65 20 62 61 63 6b 77 61 72 64 73 20   date backwards 
24e0: 0a 74 6f 20 74 68 65 20 62 65 67 69 6e 6e 69 6e  .to the beginnin
24f0: 67 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74  g of the current
2500: 20 6d 6f 6e 74 68 2c 20 79 65 61 72 20 6f 72 20   month, year or 
2510: 64 61 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  day.</p>..<p>The
2520: 20 22 77 65 65 6b 64 61 79 22 20 6d 6f 64 69 66   "weekday" modif
2530: 69 65 72 20 61 64 76 61 6e 63 65 73 20 74 68 65  ier advances the
2540: 20 64 61 74 65 20 66 6f 72 77 61 72 64 20 74 6f   date forward to
2550: 20 74 68 65 20 6e 65 78 74 20 64 61 74 65 20 0a   the next date .
2560: 77 68 65 72 65 20 74 68 65 20 77 65 65 6b 64 61  where the weekda
2570: 79 20 6e 75 6d 62 65 72 20 69 73 20 4e 2e 20 53  y number is N. S
2580: 75 6e 64 61 79 20 69 73 20 30 2c 20 4d 6f 6e 64  unday is 0, Mond
2590: 61 79 20 69 73 20 31 2c 20 61 6e 64 20 73 6f 20  ay is 1, and so 
25a0: 66 6f 72 74 68 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54  forth.</p>..<p>T
25b0: 68 65 20 22 75 6e 69 78 65 70 6f 63 68 22 20 6d  he "unixepoch" m
25c0: 6f 64 69 66 69 65 72 20 28 31 31 29 20 6f 6e 6c  odifier (11) onl
25d0: 79 20 77 6f 72 6b 73 20 69 66 20 69 74 20 69 6d  y works if it im
25e0: 6d 65 64 69 61 74 65 6c 79 20 66 6f 6c 6c 6f 77  mediately follow
25f0: 73 20 0a 61 20 74 69 6d 65 73 74 72 69 6e 67 20  s .a timestring 
2600: 69 6e 20 74 68 65 20 44 44 44 44 44 44 44 44 44  in the DDDDDDDDD
2610: 44 20 66 6f 72 6d 61 74 2e 20 0a 54 68 69 73 20  D format. .This 
2620: 6d 6f 64 69 66 69 65 72 20 63 61 75 73 65 73 20  modifier causes 
2630: 74 68 65 20 44 44 44 44 44 44 44 44 44 44 20 74  the DDDDDDDDDD t
2640: 6f 20 62 65 20 69 6e 74 65 72 70 72 65 74 65 64  o be interpreted
2650: 20 6e 6f 74 20 0a 61 73 20 61 20 4a 75 6c 69 61   not .as a Julia
2660: 6e 20 64 61 79 20 6e 75 6d 62 65 72 20 61 73 20  n day number as 
2670: 69 74 20 6e 6f 72 6d 61 6c 6c 79 20 77 6f 75 6c  it normally woul
2680: 64 20 62 65 2c 20 62 75 74 20 61 73 0a 3c 61 20  d be, but as.<a 
2690: 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 65 6e 2e  href="http://en.
26a0: 77 69 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69  wikipedia.org/wi
26b0: 6b 69 2f 55 6e 69 78 5f 74 69 6d 65 22 3e 55 6e  ki/Unix_time">Un
26c0: 69 78 20 54 69 6d 65 3c 2f 61 3e 20 2d 20 74 68  ix Time</a> - th
26d0: 65 20 0a 6e 75 6d 62 65 72 20 6f 66 20 73 65 63  e .number of sec
26e0: 6f 6e 64 73 20 73 69 6e 63 65 20 31 39 37 30 2e  onds since 1970.
26f0: 20 20 49 66 20 74 68 65 20 22 75 6e 69 78 65 70    If the "unixep
2700: 6f 63 68 22 20 6d 6f 64 69 66 69 65 72 20 64 6f  och" modifier do
2710: 65 73 20 6e 6f 74 0a 66 6f 6c 6c 6f 77 20 61 20  es not.follow a 
2720: 74 69 6d 65 73 74 72 69 6e 67 20 6f 66 20 74 68  timestring of th
2730: 65 20 66 6f 72 6d 20 44 44 44 44 44 44 44 44 44  e form DDDDDDDDD
2740: 44 20 77 68 69 63 68 20 65 78 70 72 65 73 73 65  D which expresse
2750: 73 20 74 68 65 20 6e 75 6d 62 65 72 0a 6f 66 20  s the number.of 
2760: 73 65 63 6f 6e 64 73 20 73 69 6e 63 65 20 31 39  seconds since 19
2770: 37 30 20 6f 72 20 69 66 20 6f 74 68 65 72 20 6d  70 or if other m
2780: 6f 64 69 66 69 65 72 73 0a 73 65 70 61 72 61 74  odifiers.separat
2790: 65 20 74 68 65 20 22 75 6e 69 78 65 70 6f 63 68  e the "unixepoch
27a0: 22 20 6d 6f 64 69 66 69 65 72 20 66 72 6f 6d 20  " modifier from 
27b0: 70 72 69 6f 72 20 44 44 44 44 44 44 44 44 44 44  prior DDDDDDDDDD
27c0: 20 74 68 65 6e 20 74 68 65 0a 62 65 68 61 76 69   then the.behavi
27d0: 6f 72 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e  or is undefined.
27e0: 0a 46 6f 72 20 53 51 4c 69 74 65 20 76 65 72 73  .For SQLite vers
27f0: 69 6f 6e 73 20 62 65 66 6f 72 65 20 33 2e 31 36  ions before 3.16
2800: 2e 30 20 28 32 30 31 37 2d 30 31 2d 30 32 29 2c  .0 (2017-01-02),
2810: 20 0a 74 68 65 20 22 75 6e 69 78 65 70 6f 63 68   .the "unixepoch
2820: 22 20 6d 6f 64 69 66 69 65 72 20 6f 6e 6c 79 20  " modifier only 
2830: 77 6f 72 6b 73 20 66 6f 72 0a 64 61 74 65 73 20  works for.dates 
2840: 62 65 74 77 65 65 6e 20 30 30 30 30 2d 30 31 2d  between 0000-01-
2850: 30 31 20 30 30 3a 30 30 3a 30 30 20 61 6e 64 20  01 00:00:00 and 
2860: 35 33 35 32 2d 31 31 2d 30 31 20 31 30 3a 35 32  5352-11-01 10:52
2870: 3a 34 37 20 28 75 6e 69 78 20 74 69 6d 65 73 0a  :47 (unix times.
2880: 6f 66 20 2d 36 32 31 36 37 32 31 39 32 30 30 20  of -62167219200 
2890: 74 68 72 6f 75 67 68 20 31 30 36 37 35 31 39 39  through 10675199
28a0: 31 31 36 37 29 2e 3c 2f 70 3e 0a 0a 3c 61 20 6e  1167).</p>..<a n
28b0: 61 6d 65 3d 22 6c 6f 63 61 6c 74 69 6d 65 22 3e  ame="localtime">
28c0: 3c 2f 61 3e 0a 0a 3c 70 3e 54 68 65 20 22 6c 6f  </a>..<p>The "lo
28d0: 63 61 6c 74 69 6d 65 22 20 6d 6f 64 69 66 69 65  caltime" modifie
28e0: 72 20 28 31 32 29 20 61 73 73 75 6d 65 73 20 74  r (12) assumes t
28f0: 68 65 20 74 69 6d 65 20 73 74 72 69 6e 67 20 74  he time string t
2900: 6f 20 69 74 73 20 6c 65 66 74 20 69 73 20 69 6e  o its left is in
2910: 0a 55 6e 69 76 65 72 73 61 6c 20 43 6f 6f 72 64  .Universal Coord
2920: 69 6e 61 74 65 64 20 54 69 6d 65 20 28 55 54 43  inated Time (UTC
2930: 29 20 61 6e 64 20 61 64 6a 75 73 74 73 20 74 68  ) and adjusts th
2940: 65 20 74 69 6d 65 0a 73 74 72 69 6e 67 20 73 6f  e time.string so
2950: 20 74 68 61 74 20 69 74 20 64 69 73 70 6c 61 79   that it display
2960: 73 20 6c 6f 63 61 6c 74 69 6d 65 2e 20 20 49 66  s localtime.  If
2970: 20 22 6c 6f 63 61 6c 74 69 6d 65 22 0a 66 6f 6c   "localtime".fol
2980: 6c 6f 77 73 20 61 20 74 69 6d 65 20 74 68 61 74  lows a time that
2990: 20 69 73 20 6e 6f 74 20 55 54 43 2c 20 74 68 65   is not UTC, the
29a0: 6e 20 74 68 65 20 62 65 68 61 76 69 6f 72 20 69  n the behavior i
29b0: 73 20 75 6e 64 65 66 69 6e 65 64 2e 0a 54 68 65  s undefined..The
29c0: 20 22 75 74 63 22 20 6d 6f 64 69 66 69 65 72 20   "utc" modifier 
29d0: 69 73 20 74 68 65 20 6f 70 70 6f 73 69 74 65 20  is the opposite 
29e0: 6f 66 20 22 6c 6f 63 61 6c 74 69 6d 65 22 2e 20  of "localtime". 
29f0: 20 0a 22 75 74 63 22 20 61 73 73 75 6d 65 73 20   ."utc" assumes 
2a00: 74 68 61 74 20 74 68 65 20 73 74 72 69 6e 67 0a  that the string.
2a10: 74 6f 20 69 74 73 20 6c 65 66 74 20 69 73 20 69  to its left is i
2a20: 6e 20 74 68 65 20 6c 6f 63 61 6c 20 74 69 6d 65  n the local time
2a30: 7a 6f 6e 65 20 61 6e 64 20 61 64 6a 75 73 74 73  zone and adjusts
2a40: 20 74 68 61 74 20 73 74 72 69 6e 67 20 74 6f 20   that string to 
2a50: 62 65 20 69 6e 20 55 54 43 2e 0a 49 66 20 74 68  be in UTC..If th
2a60: 65 20 70 72 69 6f 72 20 73 74 72 69 6e 67 20 69  e prior string i
2a70: 73 20 6e 6f 74 20 69 6e 20 6c 6f 63 61 6c 74 69  s not in localti
2a80: 6d 65 2c 20 74 68 65 6e 20 74 68 65 20 72 65 73  me, then the res
2a90: 75 6c 74 20 6f 66 20 22 75 74 63 22 20 69 73 0a  ult of "utc" is.
2aa0: 75 6e 64 65 66 69 6e 65 64 2e 3c 2f 70 3e 0a 0a  undefined.</p>..
2ab0: 3c 68 33 3e 45 78 61 6d 70 6c 65 73 3c 2f 68 33  <h3>Examples</h3
2ac0: 3e 0a 0a 3c 70 3e 43 6f 6d 70 75 74 65 20 74 68  >..<p>Compute th
2ad0: 65 20 63 75 72 72 65 6e 74 20 64 61 74 65 2e 3c  e current date.<
2ae0: 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e  p>..<blockquote>
2af0: 53 45 4c 45 43 54 20 64 61 74 65 28 27 6e 6f 77  SELECT date('now
2b00: 27 29 3b 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e  ');</blockquote>
2b10: 0a 0a 3c 70 3e 43 6f 6d 70 75 74 65 20 74 68 65  ..<p>Compute the
2b20: 20 6c 61 73 74 20 64 61 79 20 6f 66 20 74 68 65   last day of the
2b30: 20 63 75 72 72 65 6e 74 20 6d 6f 6e 74 68 2e 3c   current month.<
2b40: 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65  /p>..<blockquote
2b50: 3e 53 45 4c 45 43 54 20 64 61 74 65 28 27 6e 6f  >SELECT date('no
2b60: 77 27 2c 27 73 74 61 72 74 20 6f 66 20 6d 6f 6e  w','start of mon
2b70: 74 68 27 2c 27 2b 31 20 6d 6f 6e 74 68 27 2c 27  th','+1 month','
2b80: 2d 31 20 64 61 79 27 29 3b 0a 3c 2f 62 6c 6f 63  -1 day');.</bloc
2b90: 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 43 6f 6d 70  kquote>..<p>Comp
2ba0: 75 74 65 20 74 68 65 20 64 61 74 65 20 61 6e 64  ute the date and
2bb0: 20 74 69 6d 65 20 67 69 76 65 6e 20 61 20 75 6e   time given a un
2bc0: 69 78 20 74 69 6d 65 73 74 61 6d 70 20 31 30 39  ix timestamp 109
2bd0: 32 39 34 31 34 36 36 2e 3c 2f 70 3e 0a 0a 3c 62  2941466.</p>..<b
2be0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 53  lockquote>.    S
2bf0: 45 4c 45 43 54 20 64 61 74 65 74 69 6d 65 28 31  ELECT datetime(1
2c00: 30 39 32 39 34 31 34 36 36 2c 20 27 75 6e 69 78  092941466, 'unix
2c10: 65 70 6f 63 68 27 29 3b 0a 3c 2f 62 6c 6f 63 6b  epoch');.</block
2c20: 71 75 6f 74 65 3e 0a 0a 3c 70 3e 43 6f 6d 70 75  quote>..<p>Compu
2c30: 74 65 20 74 68 65 20 64 61 74 65 20 61 6e 64 20  te the date and 
2c40: 74 69 6d 65 20 67 69 76 65 6e 20 61 20 75 6e 69  time given a uni
2c50: 78 20 74 69 6d 65 73 74 61 6d 70 20 31 30 39 32  x timestamp 1092
2c60: 39 34 31 34 36 36 2c 20 61 6e 64 20 0a 63 6f 6d  941466, and .com
2c70: 70 65 6e 73 61 74 65 20 66 6f 72 20 79 6f 75 72  pensate for your
2c80: 20 6c 6f 63 61 6c 20 74 69 6d 65 7a 6f 6e 65 2e   local timezone.
2c90: 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74  </p>..<blockquot
2ca0: 65 3e 0a 20 20 53 45 4c 45 43 54 20 64 61 74 65  e>.  SELECT date
2cb0: 74 69 6d 65 28 31 30 39 32 39 34 31 34 36 36 2c  time(1092941466,
2cc0: 20 27 75 6e 69 78 65 70 6f 63 68 27 2c 20 27 6c   'unixepoch', 'l
2cd0: 6f 63 61 6c 74 69 6d 65 27 29 3b 0a 3c 2f 62 6c  ocaltime');.</bl
2ce0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 43 6f  ockquote>..<p>Co
2cf0: 6d 70 75 74 65 20 74 68 65 20 63 75 72 72 65 6e  mpute the curren
2d00: 74 20 75 6e 69 78 20 74 69 6d 65 73 74 61 6d 70  t unix timestamp
2d10: 2e 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f  .</p>..<blockquo
2d20: 74 65 3e 0a 20 20 53 45 4c 45 43 54 20 73 74 72  te>.  SELECT str
2d30: 66 74 69 6d 65 28 27 25 73 27 2c 27 6e 6f 77 27  ftime('%s','now'
2d40: 29 3b 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e  );.</blockquote>
2d50: 0a 0a 3c 70 3e 43 6f 6d 70 75 74 65 20 74 68 65  ..<p>Compute the
2d60: 20 6e 75 6d 62 65 72 20 6f 66 20 64 61 79 73 20   number of days 
2d70: 73 69 6e 63 65 20 74 68 65 20 73 69 67 6e 69 6e  since the signin
2d80: 67 20 6f 66 20 74 68 65 20 55 53 20 44 65 63 6c  g of the US Decl
2d90: 61 72 61 74 69 6f 6e 0a 6f 66 20 49 6e 64 65 70  aration.of Indep
2da0: 65 6e 64 65 6e 63 65 2e 3c 2f 70 3e 0a 0a 3c 62  endence.</p>..<b
2db0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 53 45 4c  lockquote>.  SEL
2dc0: 45 43 54 20 6a 75 6c 69 61 6e 64 61 79 28 27 6e  ECT julianday('n
2dd0: 6f 77 27 29 20 2d 20 6a 75 6c 69 61 6e 64 61 79  ow') - julianday
2de0: 28 27 31 37 37 36 2d 30 37 2d 30 34 27 29 3b 0a  ('1776-07-04');.
2df0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c  </blockquote>..<
2e00: 70 3e 43 6f 6d 70 75 74 65 20 74 68 65 20 6e 75  p>Compute the nu
2e10: 6d 62 65 72 20 6f 66 20 73 65 63 6f 6e 64 73 20  mber of seconds 
2e20: 73 69 6e 63 65 20 61 20 70 61 72 74 69 63 75 6c  since a particul
2e30: 61 72 20 6d 6f 6d 65 6e 74 20 69 6e 20 32 30 30  ar moment in 200
2e40: 34 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75  4:</p>..<blockqu
2e50: 6f 74 65 3e 0a 20 20 53 45 4c 45 43 54 20 73 74  ote>.  SELECT st
2e60: 72 66 74 69 6d 65 28 27 25 73 27 2c 27 6e 6f 77  rftime('%s','now
2e70: 27 29 20 2d 20 73 74 72 66 74 69 6d 65 28 27 25  ') - strftime('%
2e80: 73 27 2c 27 32 30 30 34 2d 30 31 2d 30 31 20 30  s','2004-01-01 0
2e90: 32 3a 33 34 3a 35 36 27 29 3b 0a 3c 2f 62 6c 6f  2:34:56');.</blo
2ea0: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 43 6f  ckquote>..<p>.Co
2eb0: 6d 70 75 74 65 20 74 68 65 20 64 61 74 65 20 6f  mpute the date o
2ec0: 66 20 74 68 65 20 66 69 72 73 74 20 54 75 65 73  f the first Tues
2ed0: 64 61 79 20 69 6e 20 4f 63 74 6f 62 65 72 0a 66  day in October.f
2ee0: 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 79  or the current y
2ef0: 65 61 72 2e 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63  ear..</p>..<bloc
2f00: 6b 71 75 6f 74 65 3e 0a 20 20 53 45 4c 45 43 54  kquote>.  SELECT
2f10: 20 64 61 74 65 28 27 6e 6f 77 27 2c 27 73 74 61   date('now','sta
2f20: 72 74 20 6f 66 20 79 65 61 72 27 2c 27 2b 39 20  rt of year','+9 
2f30: 6d 6f 6e 74 68 73 27 2c 27 77 65 65 6b 64 61 79  months','weekday
2f40: 20 32 27 29 3b 0a 3c 2f 62 6c 6f 63 6b 71 75 6f   2');.</blockquo
2f50: 74 65 3e 0a 0a 3c 70 3e 43 6f 6d 70 75 74 65 20  te>..<p>Compute 
2f60: 74 68 65 20 74 69 6d 65 20 73 69 6e 63 65 20 74  the time since t
2f70: 68 65 20 75 6e 69 78 20 65 70 6f 63 68 20 69 6e  he unix epoch in
2f80: 20 73 65 63 6f 6e 64 73 20 0a 28 6c 69 6b 65 20   seconds .(like 
2f90: 73 74 72 66 74 69 6d 65 28 27 25 73 27 2c 27 6e  strftime('%s','n
2fa0: 6f 77 27 29 20 65 78 63 65 70 74 20 69 6e 63 6c  ow') except incl
2fb0: 75 64 65 73 20 66 72 61 63 74 69 6f 6e 61 6c 20  udes fractional 
2fc0: 70 61 72 74 29 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f  part):</p>..<blo
2fd0: 63 6b 71 75 6f 74 65 3e 0a 20 20 53 45 4c 45 43  ckquote>.  SELEC
2fe0: 54 20 28 6a 75 6c 69 61 6e 64 61 79 28 27 6e 6f  T (julianday('no
2ff0: 77 27 29 20 2d 20 32 34 34 30 35 38 37 2e 35 29  w') - 2440587.5)
3000: 2a 38 36 34 30 30 2e 30 3b 0a 3c 2f 62 6c 6f 63  *86400.0;.</bloc
3010: 6b 71 75 6f 74 65 3e 0a 0a 3c 68 33 3e 43 61 76  kquote>..<h3>Cav
3020: 65 61 74 73 20 41 6e 64 20 42 75 67 73 3c 2f 68  eats And Bugs</h
3030: 33 3e 0a 0a 3c 70 3e 54 68 65 20 63 6f 6d 70 75  3>..<p>The compu
3040: 74 61 74 69 6f 6e 20 6f 66 20 6c 6f 63 61 6c 20  tation of local 
3050: 74 69 6d 65 20 64 65 70 65 6e 64 73 20 68 65 61  time depends hea
3060: 76 69 6c 79 20 6f 6e 20 74 68 65 20 77 68 69 6d  vily on the whim
3070: 20 0a 6f 66 20 70 6f 6c 69 74 69 63 69 61 6e 73   .of politicians
3080: 20 61 6e 64 20 69 73 20 74 68 75 73 20 64 69 66   and is thus dif
3090: 66 69 63 75 6c 74 20 74 6f 20 67 65 74 20 63 6f  ficult to get co
30a0: 72 72 65 63 74 20 66 6f 72 20 0a 61 6c 6c 20 6c  rrect for .all l
30b0: 6f 63 61 6c 65 73 2e 20 49 6e 20 74 68 69 73 20  ocales. In this 
30c0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2c 20  implementation, 
30d0: 74 68 65 20 73 74 61 6e 64 61 72 64 20 43 20 6c  the standard C l
30e0: 69 62 72 61 72 79 20 0a 66 75 6e 63 74 69 6f 6e  ibrary .function
30f0: 20 6c 6f 63 61 6c 74 69 6d 65 5f 72 28 29 20 69   localtime_r() i
3100: 73 20 75 73 65 64 20 74 6f 20 61 73 73 69 73 74  s used to assist
3110: 20 69 6e 20 74 68 65 20 63 61 6c 63 75 6c 61 74   in the calculat
3120: 69 6f 6e 20 6f 66 20 0a 6c 6f 63 61 6c 20 74 69  ion of .local ti
3130: 6d 65 2e 20 20 54 68 65 20 0a 6c 6f 63 61 6c 74  me.  The .localt
3140: 69 6d 65 5f 72 28 29 20 43 20 66 75 6e 63 74 69  ime_r() C functi
3150: 6f 6e 20 6e 6f 72 6d 61 6c 6c 79 20 6f 6e 6c 79  on normally only
3160: 20 77 6f 72 6b 73 20 66 6f 72 20 79 65 61 72 73   works for years
3170: 0a 62 65 74 77 65 65 6e 20 31 39 37 30 20 61 6e  .between 1970 an
3180: 64 20 32 30 33 37 2e 20 46 6f 72 20 64 61 74 65  d 2037. For date
3190: 73 20 6f 75 74 73 69 64 65 20 74 68 69 73 20 72  s outside this r
31a0: 61 6e 67 65 2c 20 53 51 4c 69 74 65 20 0a 61 74  ange, SQLite .at
31b0: 74 65 6d 70 74 73 20 74 6f 20 6d 61 70 20 74 68  tempts to map th
31c0: 65 20 79 65 61 72 20 69 6e 74 6f 20 61 6e 20 65  e year into an e
31d0: 71 75 69 76 61 6c 65 6e 74 20 79 65 61 72 20 77  quivalent year w
31e0: 69 74 68 69 6e 20 0a 74 68 69 73 20 72 61 6e 67  ithin .this rang
31f0: 65 2c 20 64 6f 20 74 68 65 20 63 61 6c 63 75 6c  e, do the calcul
3200: 61 74 69 6f 6e 2c 20 74 68 65 6e 20 6d 61 70 20  ation, then map 
3210: 74 68 65 20 79 65 61 72 20 62 61 63 6b 2e 3c 2f  the year back.</
3220: 70 3e 0a 0a 0a 3c 70 3e 54 68 65 73 65 20 66 75  p>...<p>These fu
3230: 6e 63 74 69 6f 6e 73 20 6f 6e 6c 79 20 77 6f 72  nctions only wor
3240: 6b 20 66 6f 72 20 64 61 74 65 73 20 62 65 74 77  k for dates betw
3250: 65 65 6e 20 30 30 30 30 2d 30 31 2d 30 31 20 30  een 0000-01-01 0
3260: 30 3a 30 30 3a 30 30 0a 61 6e 64 20 39 39 39 39  0:00:00.and 9999
3270: 2d 31 32 2d 33 31 20 32 33 3a 35 39 3a 35 39 20  -12-31 23:59:59 
3280: 28 6a 75 6c 69 64 61 6e 20 64 61 79 20 6e 75 6d  (julidan day num
3290: 62 65 72 73 20 31 37 32 31 30 35 39 2e 35 20 74  bers 1721059.5 t
32a0: 68 72 6f 75 67 68 20 35 33 37 33 34 38 34 2e 35  hrough 5373484.5
32b0: 29 2e 0a 46 6f 72 20 64 61 74 65 73 20 6f 75 74  )..For dates out
32c0: 73 69 64 65 20 74 68 61 74 20 72 61 6e 67 65 2c  side that range,
32d0: 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20   the results of 
32e0: 74 68 65 73 65 0a 66 75 6e 63 74 69 6f 6e 73 20  these.functions 
32f0: 61 72 65 20 75 6e 64 65 66 69 6e 65 64 2e 3c 2f  are undefined.</
3300: 70 3e 0a 0a 3c 70 3e 4e 6f 6e 2d 56 69 73 74 61  p>..<p>Non-Vista
3310: 20 57 69 6e 64 6f 77 73 20 70 6c 61 74 66 6f 72   Windows platfor
3320: 6d 73 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 20  ms only support 
3330: 6f 6e 65 20 73 65 74 20 6f 66 20 44 53 54 20 72  one set of DST r
3340: 75 6c 65 73 2e 20 0a 56 69 73 74 61 20 6f 6e 6c  ules. .Vista onl
3350: 79 20 73 75 70 70 6f 72 74 73 20 74 77 6f 2e 20  y supports two. 
3360: 54 68 65 72 65 66 6f 72 65 2c 20 6f 6e 20 74 68  Therefore, on th
3370: 65 73 65 20 70 6c 61 74 66 6f 72 6d 73 2c 20 0a  ese platforms, .
3380: 68 69 73 74 6f 72 69 63 61 6c 20 44 53 54 20 63  historical DST c
3390: 61 6c 63 75 6c 61 74 69 6f 6e 73 20 77 69 6c 6c  alculations will
33a0: 20 62 65 20 69 6e 63 6f 72 72 65 63 74 2e 20 0a   be incorrect. .
33b0: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 6e 20  For example, in 
33c0: 74 68 65 20 55 53 2c 20 69 6e 20 32 30 30 37 20  the US, in 2007 
33d0: 74 68 65 20 44 53 54 20 72 75 6c 65 73 20 63 68  the DST rules ch
33e0: 61 6e 67 65 64 2e 20 0a 4e 6f 6e 2d 56 69 73 74  anged. .Non-Vist
33f0: 61 20 57 69 6e 64 6f 77 73 20 70 6c 61 74 66 6f  a Windows platfo
3400: 72 6d 73 20 61 70 70 6c 79 20 74 68 65 20 6e 65  rms apply the ne
3410: 77 20 32 30 30 37 20 44 53 54 20 72 75 6c 65 73  w 2007 DST rules
3420: 20 0a 74 6f 20 61 6c 6c 20 70 72 65 76 69 6f 75   .to all previou
3430: 73 20 79 65 61 72 73 20 61 73 20 77 65 6c 6c 2e  s years as well.
3440: 20 56 69 73 74 61 20 64 6f 65 73 20 73 6f 6d 65   Vista does some
3450: 77 68 61 74 20 62 65 74 74 65 72 0a 67 65 74 74  what better.gett
3460: 69 6e 67 20 72 65 73 75 6c 74 73 20 63 6f 72 72  ing results corr
3470: 65 63 74 20 62 61 63 6b 20 74 6f 20 31 39 38 36  ect back to 1986
3480: 2c 20 77 68 65 6e 20 74 68 65 20 72 75 6c 65 73  , when the rules
3490: 20 77 65 72 65 20 61 6c 73 6f 20 63 68 61 6e 67   were also chang
34a0: 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 6c 6c 20  ed.</p>..<p>All 
34b0: 69 6e 74 65 72 6e 61 6c 20 63 6f 6d 70 75 74 61  internal computa
34c0: 74 69 6f 6e 73 20 61 73 73 75 6d 65 20 74 68 65  tions assume the
34d0: 20 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a   .<a href="http:
34e0: 2f 2f 65 6e 2e 77 69 6b 69 70 65 64 69 61 2e 6f  //en.wikipedia.o
34f0: 72 67 2f 77 69 6b 69 2f 47 72 65 67 6f 72 69 61  rg/wiki/Gregoria
3500: 6e 5f 63 61 6c 65 6e 64 61 72 22 3e 47 72 65 67  n_calendar">Greg
3510: 6f 72 69 61 6e 20 63 61 6c 65 6e 64 61 72 3c 2f  orian calendar</
3520: 61 3e 0a 73 79 73 74 65 6d 2e 20 20 49 74 20 69  a>.system.  It i
3530: 73 20 61 6c 73 6f 20 61 73 73 75 6d 65 64 20 74  s also assumed t
3540: 68 61 74 20 65 76 65 72 79 0a 64 61 79 20 69 73  hat every.day is
3550: 20 65 78 61 63 74 6c 79 20 38 36 34 30 30 20 73   exactly 86400 s
3560: 65 63 6f 6e 64 73 20 69 6e 20 64 75 72 61 74 69  econds in durati
3570: 6f 6e 2e 3c 2f 70 3e 0a 0a 0a                    on.</p>...