jason.stdlib.time Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jason Show documentation

Jason is a fully-fledged interpreter for an extended version of AgentSpeak, a BDI agent-oriented logic programming language.

There is a newer version: 2.3

Show newest version

package jason.stdlib;

import jason.asSemantics.DefaultInternalAction;
import jason.asSemantics.InternalAction;
import jason.asSemantics.TransitionSystem;
import jason.asSemantics.Unifier;
import jason.asSyntax.NumberTermImpl;
import jason.asSyntax.Term;

import java.util.Calendar;
import java.util.GregorianCalendar;

/**

  Internal action: .time(HH,MM,SS).
  
  
Description: gets the current time (hour, minute, and seconds).

  
Parameters:

  
  +/- hours (number): the hours (0--23).
  +/- minutes (number): the minutes (0--59).
  +/- seconds (number): the seconds (0--59).
  
  
  
  Examples:
 

   .time(H,M,S): unifies H with the current hour, M
  with the current minutes, and S with the current seconds.

   .time(15,_,_): succeeds if it is now 3pm or a bit later
  but not yet 4pm.

  

  @see jason.stdlib.date
  @see jason.functions.time function time
  
 */
public class time extends DefaultInternalAction {
    
    private static InternalAction singleton = null;
    public static InternalAction create() {
        if (singleton == null) 
            singleton = new time();
        return singleton;
    }
    
    @Override public int getMinArgs() { return 3; }
    @Override public int getMaxArgs() { return 3; }

    @Override
    public Object execute(TransitionSystem ts, Unifier un, Term[] args) throws Exception {
        checkArguments(args);

        Calendar now = new GregorianCalendar();
        return un.unifies(args[0], new NumberTermImpl(now.get(Calendar.HOUR_OF_DAY))) &&
               un.unifies(args[1], new NumberTermImpl(now.get(Calendar.MINUTE))) &&
               un.unifies(args[2], new NumberTermImpl(now.get(Calendar.SECOND)));
    }
}