home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / cug / softt-3.lbr / GETNOW.DQC / GETNOW.DOC
Text File  |  1984-07-05  |  1KB  |  65 lines
  1. .bp 1
  2. .in 0
  3. .he 'GETNOW (2)'09/25/80'GETNOW (2)'
  4. .fo ''-#-''
  5. .fi
  6. .in 7
  7. .ti -7
  8. NAME
  9. .br
  10. getnow -
  11. determine current date and time
  12. .sp 1
  13. .ti -7
  14. SYNOPSIS
  15. .br
  16. .nf
  17. subroutine getnow (now)
  18. integer now (7)
  19. .fi
  20. .sp
  21. .ti -7
  22. DESCRIPTION
  23. .br
  24. 'Getnow' is used to query the operating system for the current date
  25. and time.
  26. The requested information is returned in a seven-word integer array,
  27. where:
  28. word 1 contains the year (e.g. 1980);
  29. word 2 contains the month (e.g. 9);
  30. word 3 contains the day (e.g. 25);
  31. word 4 contains the hour (e.g. 13);
  32. word 5 contains the minute (e.g. 39);
  33. word 6 contains the second (e.g. 14);
  34. word 7 contains the millisecond (e.g. 397).
  35. .sp
  36. The information returned by 'getnow' may be used as-is or further
  37. useful processing may be done by 'fmtdat' or 'wkday'.
  38. .sp
  39. .ti -7
  40. IMPLEMENTATION
  41. .br
  42. Operating systems generally have some mechanism for picking
  43. up the current date and time.
  44. If yours has one, use it.
  45. .sp
  46. Getnow is not critical to the implementation of the tools and
  47. can be left as a stub if the operating system cannot supply
  48. the needed information.
  49. .sp
  50. .ti -7
  51. ARGUMENTS MODIFIED
  52. .br
  53. now
  54. .sp
  55. .ti -7
  56. BUGS
  57. .br
  58. Some systems cannot obtain all the time information described.
  59. Array elements that cannot be filled default to zero.
  60. .sp
  61. .ti -7
  62. SEE ALSO
  63. .br
  64. fmtdat (2), wkday (2), date (1)
  65.