GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ROSE::HTML::FORM::FIELD::TIME::SPLIT::HOURMINUTESECOND (3)

.ds Aq ’

NAME

Rose::HTML::Form::Field::Time::Split::HourMinuteSecond - Compound field for times with separate text fields for hour, minute, and second, and a pop-up menu for selecting AM or PM.

CONTENTS

SYNOPSIS



    $field =
      Rose::HTML::Form::Field::Time::Split::HourMinuteSecond->new(
        label   => Time,
        name    => time, 
        default => 8am);

    print $field->field(hour)->internal_value; # "08"

    $field->input_value(13:00:00 PM);

    # "AM/PM only valid with hours less than 12"
    $field->validate or warn $field->error;

    $field->input_value(blah);

    # "Invalid time"
    $field->validate or warn $field->error;

    $field->input_value(6:30 a.m.);

    print $field->internal_value; # "06:30:00 AM"

    print $field->html;
    ...



DESCRIPTION

Rose::HTML::Form::Field::Time::Split::HourMinuteSecond is a compound field for times with separate text fields for hour, minute, and second, and a pop-up menu for selecting AM or PM.

This class inherits (indirectly) from both Rose::HTML::Form::Field::Time and Rose::HTML::Form::Field::Compound. This doesn’t quite work out as expected without a bit of tweaking. We’d like inflate_value() and validate() methods to be inherited from Rose::HTML::Form::Field::Time, but everything else to be inherited from Rose::HTML::Form::Field::Compound.

To solve this problem, there’s an intermediate class that imports the correct set of methods. This class then inherits from the intermediate class. To solve this problem, there’s an intermediate class that imports the correct set of methods. This class then inherits from the intermediate class. This works, and isolates the tricky bits to a single intermediate class, but it also demonstrates the problems that can crop up when multiple inheritance is combined with a strong aversion to code duplication.

A simpler example of a compound field can be found in Rose::HTML::Form::Field::PhoneNumber::US::Split. It too uses multiple inheritance, but its family tree is more conveniently built, saving it from selective method importing shenanigans.

This field also overrides the is_full()|Rose::HTML::Form::Field::Compound/is_full method. A valid time can be extracted from the field as long as both the hour and AM/PM subfields are not empty. All other empty fields will be treated as if they contained zeros (00).

It is important that this class (indirectly) inherits from Rose::HTML::Form::Field::Compound. See the Rose::HTML::Form::Field::Compound documentation for more information.

AUTHOR

John C. Siracusa (siracusa@gmail.com)

LICENSE

Copyright (c) 2010 by John C. Siracusa. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 ROSE::HTML::FORM::FIELD::TIME::SPLIT::HOURMINUTESECOND (3) 2015-03-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.