Class: DateSelect

Source Location: /forms/items/DateSelect.class.php

Class Overview

ABSTObject
   |
   --ABSTHTMLTag
      |
      --ABSTHTMLFormItem
         |
         --DateSelect

Author(s):

Daniel Plücken <daniel@debakel.net>

Version:

0.4.45

Copyright:

Copyright (C) 2003 Daniel Plücken <daniel@debakel.net>
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Inherited Variables

Class: ABSTHTMLFormItem

ABSTHTMLFormItem::$enabled
ABSTHTMLFormItem::$label_obj
ABSTHTMLFormItem::$manipulateable
ABSTHTMLFormItem::$parentform
ABSTHTMLFormItem::$value

Class: ABSTHTMLTag

ABSTHTMLTag::$blur
ABSTHTMLTag::$click
ABSTHTMLTag::$focus
ABSTHTMLTag::$freestyle
ABSTHTMLTag::$id
ABSTHTMLTag::$mousemove
ABSTHTMLTag::$mouseout
ABSTHTMLTag::$mouseover
ABSTHTMLTag::$mouseup
ABSTHTMLTag::$name
ABSTHTMLTag::$no_format
ABSTHTMLTag::$other_attributes
ABSTHTMLTag::$style_class

Inherited Methods

Class: ABSTHTMLFormItem

ABSTHTMLFormItem::addValue(): Concats the given string to the value of this item's "value"-attribute.
ABSTHTMLFormItem::disable(): Disables this item. This method is an alias for the method setDisabled().
ABSTHTMLFormItem::enable(): Enables this item. This method is an alias for the method setDisabled().
ABSTHTMLFormItem::getCheckOrder(): Blind method cause other objects will invoke it.
ABSTHTMLFormItem::getLabel(): Returns the label to the extended extended underlying form component as string.
ABSTHTMLFormItem::getValidationOrder(): Blind method cause other objects will invoke it.
ABSTHTMLFormItem::getValue(): Returns the value of this item's "value"-attribute.
ABSTHTMLFormItem::HTMLFormItem(): Constructor
ABSTHTMLFormItem::setDisabled(): Disables this item.
ABSTHTMLFormItem::setEnabled(): Enables this item.
ABSTHTMLFormItem::setLabel(): Stores the given label object to the extended underlying form component.
ABSTHTMLFormItem::setManipulateable(): Makes sure that this item is manipulateable by the user.
ABSTHTMLFormItem::setNotManipulateable(): Makes sure that this item is not manipulateable by the user, but carrys the value trough the form.
ABSTHTMLFormItem::setParentForm(): Stores a reference to the form-object that contains this item-object.
ABSTHTMLFormItem::setValue(): Stores the value of this item's "value"-attribute.

Class: ABSTHTMLTag

ABSTHTMLTag::getId(): Returns the value of this tag's "id"-attribute.
ABSTHTMLTag::getName(): Returns the value of this tag's "name"-attribute.
ABSTHTMLTag::HTMLTag(): The Constructor let the script die, cause this is an abstract class!
ABSTHTMLTag::idExists(): Stores all used ids and makes sure that every id in the document is unique. It should called in every get method of classes in the packages forms and html.
ABSTHTMLTag::setAttributes(): This method allows to set the attributes of the tag that are not handled by other methods.
ABSTHTMLTag::setFreeStyle(): Set the value of style definitions that are not handled by implemented methods.
ABSTHTMLTag::setId(): Stores the value of this item's "id"-attribute.
ABSTHTMLTag::setName(): Stores the value of this tag's "name"-attribute.
ABSTHTMLTag::setNoFormat(): Stores that the HTML-elements should not format by "\r\n" in the source.
ABSTHTMLTag::setOnBlur(): Sets the value of the blur-attribute of this html-tag.
ABSTHTMLTag::setOnClick(): Sets the value of the click-attribute of this html-tag.
ABSTHTMLTag::setOnFocus(): Sets the value of the focus-attribute of this html-tag.
ABSTHTMLTag::setOnMouseMove(): Sets the value of the mousemove-attribute of this html-tag.
ABSTHTMLTag::setOnMouseOut(): Sets the value of the mouseout-attribute of this html-tag.
ABSTHTMLTag::setOnMouseOver(): Sets the value of the mouseover-attribute of this html-tag.
ABSTHTMLTag::setOnMouseUp(): Sets the value of the mouseup-attribute of this html-tag.
ABSTHTMLTag::setStyle(): Set the value of the class-attribute of this tag.

Class: ABSTObject

ABSTObject::printComplexData(): Prints out the more complex data by the given array.
ABSTObject::printPrimitiveData(): Prints out the primitive data by the given arrays.
ABSTObject::printStructure(): Prints out the Structure of this Object.
ABSTObject::same(): Checks whether the passed object reference points to this object.
ABSTObject::sameReferences(): Compares two references whether they points to the same object

Class Details

[line 63]

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	0.4.45
copyright:	Copyright (C) 2003 Daniel Plücken <daniel@debakel.net> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
license:	GNU Lesser General Public License

[ Top ]

Class Variables

$daySelect = null

[line 102]

Tags:

access:

private

Type:

HTMLSelect

[ Top ]

$hourSelect = null

[line 97]

Tags:

access:

private

Type:

HTMLSelect

[ Top ]

$jscheck = true

[line 128]

Tags:

access:

private

Type:

boolean

[ Top ]

$minuteSelect = null

[line 92]

Tags:

access:

private

Type:

HTMLSelect

[ Top ]

$monthSelect = null

[line 117]

Tags:

access:

private

Type:

HTMLSelect

[ Top ]

$onlyfuturedates = false

[line 133]

Tags:

access:

private

Type:

boolean

[ Top ]

$onlyfutureJSerrMSG = "Der Termin liegt in der Vergangenheit!"

[line 138]

Tags:

access:

private

Type:

string

[ Top ]

$output_template_str = "{#WEEKDAY#}\r\n{#DAY#}\r\n{#MONTH#}\r\n{#WEEKNUM#}\r\n{#YEAR#}\r\n{#HOUR#}\r\n{#MINUTE#}\r\n{#SECOND#}\r\n"

[line 143]

Tags:

access:

public

Type:

string

[ Top ]

$secondSelect = null

[line 87]

Tags:

access:

private

Type:

HTMLSelect

[ Top ]

$SETTING =

[line 69]

Tags:

access:

private

Type:

array

[ Top ]

$standard_date_format = "timestamp"

[line 81]

Tags:

access:

private

Type:

string

[ Top ]

$timestamp =

[line 75]

Tags:

access:

private

Type:

int

[ Top ]

$weekdaySelect = null

[line 107]

Tags:

access:

private

Type:

HTMLSelect

[ Top ]

$weeknumSelect = null

[line 112]

Tags:

access:

private

Type:

HTMLSelect

[ Top ]

$yearSelect = null

[line 122]

Tags:

access:

private

Type:

HTMLSelect

[ Top ]

Class Methods

constructor DateSelect [line 157]

DateSelect DateSelect(
[string
$name = ""], [
$minuteinterval = 5], [
$secondinterval = 15], integer
$minuteintervall, integer
$secondintervall)

Constructor

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.4
since:	0.1.0
access:	public

Parameters:

string	$name
integer	$minuteintervall
integer	$secondintervall
	$minuteinterval
	$secondinterval

[ Top ]

method disableJSCheck [line 686]

void disableJSCheck(
)

With this method you can disable the checkup of guilty dates by javascript.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.1.4
access:	public

[ Top ]

method extractMinuteFromTimestamp [line 1282]

string extractMinuteFromTimestamp(

$timestamp, string
$selectedValue, boolean
$hidden)

Gets the minute of a given timestamp and rounds it to the nearest value of the minute select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$hidden
	$timestamp

[ Top ]

method extractSecondFromTimestamp [line 1256]

string extractSecondFromTimestamp(

$timestamp, string
$selectedValue, boolean
$hidden)

Gets the second of a given timestamp and rounds it to the nearest value of the second select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$hidden
	$timestamp

[ Top ]

method get [line 1305]

string get(
[
$str_format = ""])

Returns a generated string based on the attributes of this object.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.45
since:	0.1.0
access:	public

Parameters:

$str_format

[ Top ]

method getClone [line 336]

object getClone(
[string
$newName = ""])

Returns a clone of this object.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.1.4
access:	public

Parameters:

string

$newName

[ Top ]

method getDaySelect [line 561]

string getDaySelect(
)

Returns a generated string based on the attributes of this object's day-select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

[ Top ]

method getHourSelect [line 536]

string getHourSelect(
)

Returns a generated string based on the attributes of this object's hour-select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

[ Top ]

method getISODate [line 425]

string getISODate(
[mixed
$itemname_or_timestamp = ""])

Returns an iso date from a given timestamp or extracts the iso date from

request data of a form component, that was generated with this class. In last case you only have to give in the name you used with the constructor to generate an object of this class. In both upper cases this method can be called statically. If no parameter was given, the method tries to get the date from class variable $timestamp, which can be set by the method setTimestamp() of this class.

Tags:

version:	1.01
since:	0.4.42
access:	public

Parameters:

mixed

$itemname_or_timestamp

[ Top ]

method getJSFunctionsToCheckDate [line 1391]

string getJSFunctionsToCheckDate(
)

Creates javascript-functions to verify the date choosen by an user.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.1
since:	0.2.3
access:	public

[ Top ]

method getMinuteSelect [line 511]

string getMinuteSelect(
)

Returns a generated string based on the attributes of this object's minute-select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

[ Top ]

method getMonthSelect [line 636]

string getMonthSelect(
)

Returns a generated string based on the attributes of this object's minute-select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.1
since:	0.1.0
access:	public

[ Top ]

method getName [line 731]

string getName(
)

Returns the name suffix of this select group.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.1.4
access:	public

Overrides ABSTHTMLTag::getName() (Returns the value of this tag's "name"-attribute.)

[ Top ]

method getSecondSelect [line 392]

string getSecondSelect(
)

Returns a generated string based on the attributes of this object's second-select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

[ Top ]

method getTimestamp [line 462]

integer getTimestamp(
)

Returns the timestamp value that can compute from the values of the selects.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.4.2
access:	public

[ Top ]

method getWeekDaySelect [line 586]

string getWeekDaySelect(
)

Returns a generated string based on the attributes of this object's weekday-select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

[ Top ]

method getWeeknumSelect [line 611]

string getWeeknumSelect(
)

Returns a generated string based on the attributes of this object's minute-select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.1
since:	0.1.0
access:	public

[ Top ]

method getYearSelect [line 661]

string getYearSelect(
)

Returns a generated string based on the attributes of this object's minute-select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

[ Top ]

method setDaySelect [line 944]

string setDaySelect(
[string
$selectedValue = ""], [boolean
$hidden = false])

Sets up the item to selecting the day of a date.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.4
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$hidden

[ Top ]

method setHourSelect [line 881]

string setHourSelect(
[string
$selectedValue = ""], [boolean
$hidden = false], [boolean
$show_emptylabel = false], [integer
$begin = 0], [integer
$end = 23])

Sets up the item to selecting the hour of a date.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.5
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$hidden
boolean	$show_emptylabel
integer	$begin
integer	$end

[ Top ]

method setISODate [line 316]

void setISODate(
integer
$str_iso_date)

Sets the values of the select group with the given ISO date.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.4.1
access:	public

Parameters:

integer

$str_iso_date

[ Top ]

method setMinuteSelect [line 813]

string setMinuteSelect(
[string
$selectedValue = ""], [boolean
$hidden = false], [boolean
$show_emptylabel = false])

Sets up the item to selecting the minute of a date.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.4
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$hidden
boolean	$show_emptylabel

[ Top ]

method setMonthSelect [line 1112]

string setMonthSelect(
[string
$selectedValue = ""], [
$kind = "NAMES"], [
$hidden = false], [
$show_emptylabel = false], boolean
$year)

Sets up the item to selecting the month of a given year.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$year
	$kind
	$hidden
	$show_emptylabel

[ Top ]

method setOnlyFutureDates [line 701]

void setOnlyFutureDates(
)

With this method you can set the checkup of guilty dates in the future by javascript.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.1.4
access:	public

[ Top ]

method setOnlyFutureErrMSG [line 717]

void setOnlyFutureErrMSG(
string
$string)

With this method you can set the message that should appear if the given date isn't a date in the future.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.1.4
access:	public

Parameters:

string

$string

[ Top ]

method setOutputTemplate [line 242]

void setOutputTemplate(
string
$str_template)

This sets in which order the selects should be output.

You can use following placeholders:

{#WEEKDAY#} - For the weekdays select
{#DAY#} - For the days select.
{#MONTH#} - For the months select.
{#YEAR#} - For the years select.
{#HOUR#} - For the hours select.
{#MINUTE#} - For the minutes select.
{#SECOND#} - For the seconds select.
{#WEEKNUM#} - For the weeknums select.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.4.4
access:	public

Parameters:

string

$str_template

[ Top ]

method setSecondSelect [line 748]

string setSecondSelect(
[string
$selectedValue = ""], [boolean
$hidden = false], [boolean
$show_emptylabel = false])

Sets up the item to selecting the second of a date.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.4
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$hidden
boolean	$show_emptylabel

[ Top ]

method setStandardDateFormat [line 213]

void setStandardDateFormat(
string
$str_kind)

This sets how the selected date should be standardly handled. The Following

values are allowed:

ISO - Means that the selected value of this widget will be put in a database relation in an ISO-Format, if it is a member of a DBTfillingForm.
TIMESTAMP - Means that the selected value of this widget will be put in a database relation in an UNIX-Timestamp-Format, if it is a member of a DBTfillingForm. This is the first standard if no other declaration was made.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.0
since:	0.4.3
access:	public

Parameters:

string

$str_kind

[ Top ]

method setStandardYearSelect [line 1225]

string setStandardYearSelect(
[
$selectedIndex = ""], [boolean
$hidden = false], string
$selectedValue)

Sets up the item to selecting the year of date. It will start on tree years ago and two years int he future

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$hidden
	$selectedIndex

[ Top ]

method setTimestamp [line 257]

void setTimestamp(
integer
$timestamp)

Sets the values of the select group with the given timestamp.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.01
since:	0.1.4
access:	public

Parameters:

integer

$timestamp

[ Top ]

method setWeekDaySelect [line 993]

string setWeekDaySelect(
[string
$selectedValue = ""], [
$kind = "NAMES"], [boolean
$hidden = false], [boolean
$show_emptylabel = false])

Sets up the item to selecting the weekday of a date.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.4
since:	0.1.0
access:	public

Parameters:

string	$selectedValue
boolean	$hidden
boolean	$show_emptylabel
	$kind

[ Top ]

method setWeeknumSelect [line 1058]

string setWeeknumSelect(
[string
$selectedValue = ""], [integer
$year = ""], [boolean
$hidden = false])

Sets up the item to selecting the weeknum of a given year.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.2
access:	public

Parameters:

string	$selectedValue
integer	$year
boolean	$hidden

[ Top ]

method setYearSelect [line 1179]

string setYearSelect(
integer
$yearBegin, integer
$yearEnd, [string
$selectedValue = ""], [boolean
$hidden = false])

Sets up the item to selecting the year of a date. You have to define the value on which it should start and this one on which it should end.

Tags:

author:	Daniel Plücken <daniel@debakel.net>
version:	1.2
since:	0.1.0
access:	public

Parameters:

integer	$yearBegin
integer	$yearEnd
string	$selectedValue
boolean	$hidden

[ Top ]

Documentation generated on Thu, 05 Jun 2008 19:10:55 +0200 by phpDocumentor 1.4.1