A time form function

The post was to see if it would be friendly, I'll start writing it now.

Here's a patch - in looking at the other functions it seems the trend is to create an entire field to put in, but I felt uncomfortable doing that - what I wrote could be utilized to produce that easily enough though should that be the desired direction.

I havn't spent that much time on this, doing 5 things at once is the only reason why it took so long. I haven't yet looked at the date api either (saw your post after I produced the patch)

Can't change assign when not creating a new post.

For the documentation page, should this patch be integrated:

time_select_for_form($hour = 12)
This will return the options selection for an '#options' for a selection. From this point, it is a relatively easy thing to construct a time selection.

• Calling parameters
  
  $hour
  Pass this as anything other than a 12, and the function shall be formatted for a 24 hour timeframe, pass no argument, and it shall return for a 12 hour timeframe
• Return
  
  An array with keys, the 'hour' key will have the hours options, 'minute' key will have the minutes options, the 'second' key will have the seconds options, and if it is a 12 hour format, the 'ampm' key will have the am and pm options.

Okay, updated it to fit with other parts of the module.

Documentation:

time_select_for_form($select, $hour = FALSE, $title = 'Time', $default_value = NULL, $required = FALSE, $description = '', $multiple = FALSE)

• Calling parameters
  
  $select
  To choose which options to provide. The choices are 'hour', 'minute', 'second', 'ampm'.
  $hour
  If this value is TRUE, then it will be returning hour in a 12 hour format, if not passed, it will return hour in a 24 hour format.
  $title
  Defaults to "Time" and it will always be translated.
  $default_value
  The selected value when the page loads. Do not include leading 0's for values under 10. The select form will have them, but don't include them in the call.
  $required
  Whether the element should be required or not.
  $description
  optionally provide a description. it Is translated.
  $multiple
  Whether or not to allow multiple choices.
• Return
  
  A compleated form element ready to be used.

As far as other developments I could forsee doing in time (came to me when writing this post)

Add a prefix and suffix to the select adding div's (being dependant on the $select) for CSS guru's - having an hour select, a minute select, a second select, and an ampm select is all well and good, but by default they would be one above the other. Better if they are side by side.

In addition to provide an 'NA' option if it is not required (NA would work in a select for 2 numbers/letters as these all are).