PrintQueue.UntilTimeOfDay PrintQueue.UntilTimeOfDay PrintQueue.UntilTimeOfDay PrintQueue.UntilTimeOfDay Property

Definición

Obtiene o establece la última hora del día, expresada como el número de minutos después de la medianoche de la hora universal coordinada (UTC) (también denominada hora del meridiano de Greenwich [GMT]), a la que la impresora imprimirá un trabajo.Gets or sets the latest time, expressed as the number of minutes after midnight Coordinated Universal Time (UTC) (also called Greenwich Mean Time [GMT]), that the printer will print a job.

public:
 virtual property int UntilTimeOfDay { int get(); void set(int value); };
public virtual int UntilTimeOfDay { get; set; }
member this.UntilTimeOfDay : int with get, set
Public Overridable Property UntilTimeOfDay As Integer

Valor de propiedad

Hora del día a la que la impresora ya no está disponible, expresada como el número de minutos después de medianoche (UTC).The time of day that the printer is no longer available, expressed as the number of minutes after midnight (UTC). El valor máximo es 1439.The maximum value is 1439. Cuando una impresora se instala por primera vez utilizando el Asistente para agregar impresoras de Microsoft WindowsMicrosoft Windows, la impresora toma como valor predeterminado estar disponible todo el tiempo, y esta propiedad devuelve 0 en todas las zonas horarias.When a printer is first installed by using the Microsoft WindowsMicrosoft Windows Add Printer Wizard, the printer defaults to being available all the time, and this property returns 0 in all time zones.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar esta propiedad para determinar si una impresora está disponible en el momento actual.The following example shows how to use this property to determine whether a printer is available at the present time.

private: 
   static void ReportAvailabilityAtThisTime (System::String^% statusReport, System::Printing::PrintQueue^ pq) 
   {
      if (pq->StartTimeOfDay != pq->UntilTimeOfDay)
      {
         System::DateTime utcNow = DateTime::UtcNow;
         System::Int32 utcNowAsMinutesAfterMidnight = (utcNow.TimeOfDay.Hours * 60) + utcNow.TimeOfDay.Minutes;

         // If now is not within the range of available times . . .
         if (!((pq->StartTimeOfDay < utcNowAsMinutesAfterMidnight) && (utcNowAsMinutesAfterMidnight < pq->UntilTimeOfDay)))
         {
            statusReport = statusReport + " Is not available at this time of day. ";
         }
      }
   };
private static void ReportAvailabilityAtThisTime(ref String statusReport, PrintQueue pq)
{
    if (pq.StartTimeOfDay != pq.UntilTimeOfDay) // If the printer is not available 24 hours a day
    {
DateTime utcNow = DateTime.UtcNow;
Int32 utcNowAsMinutesAfterMidnight = (utcNow.TimeOfDay.Hours * 60) + utcNow.TimeOfDay.Minutes;
        
        // If now is not within the range of available times . . .
        if (!((pq.StartTimeOfDay < utcNowAsMinutesAfterMidnight) 
           &&
           (utcNowAsMinutesAfterMidnight < pq.UntilTimeOfDay)))
        {
            statusReport = statusReport + " Is not available at this time of day. ";
        }
    }
}
Private Shared Sub ReportAvailabilityAtThisTime(ByRef statusReport As String, ByVal pq As PrintQueue)
    If pq.StartTimeOfDay <> pq.UntilTimeOfDay Then ' If the printer is not available 24 hours a day
Dim utcNow As Date = Date.UtcNow
Dim utcNowAsMinutesAfterMidnight As Int32 = (utcNow.TimeOfDay.Hours * 60) + utcNow.TimeOfDay.Minutes

        ' If now is not within the range of available times . . .
        If Not((pq.StartTimeOfDay < utcNowAsMinutesAfterMidnight) AndAlso (utcNowAsMinutesAfterMidnight < pq.UntilTimeOfDay)) Then
            statusReport = statusReport & " Is not available at this time of day. "
        End If
    End If
End Sub

Comentarios

Si no está en la zona horaria UTC, debe agregar o restar múltiplos de 60 para establecer u obtener la hora correcta para la zona horaria.If you are not in the UTC time zone, you must add or subtract multiples of 60 to set or get the correct time for your time zone. Por ejemplo, si se encuentra en la zona horaria del Pacífico de Norteamérica y el horario de verano no está en vigor, la hora local es 8 horas anterior a la hora UTC.For example, if you are in the Pacific Time Zone of North America and daylight savings time is not in effect, then your local time is 8 hours earlier than UTC. Para establecer UntilTimeOfDay en 12 AM en la zona horaria, establézcalo en 8 a.m. UTC, que es 480 (= 8 * 60).To set UntilTimeOfDay to 12 AM in your time zone, you set it to 8 AM UTC, which is 480 (= 8 * 60). También debe recordar que el tiempo se revierte a cero después de la 24 hora (el minuto 1439th).You also must remember that time rolls over to zero after the 24th hour (the 1439th minute). Para establecerlo en 6 PM en la zona horaria, establézcalo en 2 A.M. UTC, que es 120 (= 2 * 60).To set it to 6 PM in your time zone, you set it to 2 AM UTC, which is 120 (= 2 * 60). Vea TimeZonelas TimeSpanclases, DateTime y para obtener métodos útiles de manipulación de zona horaria.See TimeZone, TimeSpan, and DateTime classes for helpful time zone manipulating methods.

Si la impresora está siempre disponible, esta propiedad devuelve 0 en todas las zonas horarias.If the printer is always available, then this property returns 0 in all time zones.

Se aplica a

Consulte también: