All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.hpe.adm.nga.sdk.model.DateFieldModel Maven / Gradle / Ivy

The newest version!
/*
 * Copyright 2016-2023 Open Text.
 *
 * The only warranties for products and services of Open Text and
 * its affiliates and licensors (“Open Text”) are as may be set forth
 * in the express warranty statements accompanying such products and services.
 * Nothing herein should be construed as constituting an additional warranty.
 * Open Text shall not be liable for technical or editorial errors or
 * omissions contained herein. The information contained herein is subject
 * to change without notice.
 *
 * Except as specifically indicated otherwise, this document contains
 * confidential information and a valid license is required for possession,
 * use or copying. If this work is provided to the U.S. Government,
 * consistent with FAR 12.211 and 12.212, Commercial Computer Software,
 * Computer Software Documentation, and Technical Data for Commercial Items are
 * licensed to the U.S. Government under vendor's standard commercial license.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *   http://www.apache.org/licenses/LICENSE-2.0
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.hpe.adm.nga.sdk.model;

import java.time.ZoneId;
import java.time.ZonedDateTime;

/**
 *
 * This class holds the DateFieldModel objects and serves as a ZonedDateTime type FieldModel data holder.  Note according to
 * the Octane server specification all dates are stored in the UTC time zone.  Therefore when sending information to the
 * server the timezone is converted to UTC (whilst keeping the same instant).  All dates that are returned are in the UTC
 * time zone and it is up to the consumer to convert to the correct time zone if necessary
 *
 *
 */
public class DateFieldModel implements FieldModel {
	
	//Private 
		private String name = "";
		private ZonedDateTime value = null;
		
		/**
		 * Creates a new DateFieldModel object
		 * 
		 * @param newName - Field name
		 * @param newValue - Field Value
		 */
		public DateFieldModel(String newName,ZonedDateTime newValue){
			
			setValue(newName,newValue);
		}
		
		/**
		 * get the date in the UTC time zone
		 */
		public ZonedDateTime getValue()	{
			return value;
		}

	/**
		 * get Field's name
		 */
		public String getName(){
			return name;
		}
		
		/**
		 * set Field's name/value.  The timezone will be converted to UTC upon being sent to the server
		 */
		public void setValue(String newName,ZonedDateTime newValue){
			
			name = newName;
			value = newValue == null ? null : newValue.withZoneSameInstant(ZoneId.of("Z"));
		}


}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy